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ABSTRACT • * 

L The Computer-Assisted Data Analysing (CA£AJf Mcnitor is 

a conversational-language interactive computer software package 
intended for several audiences. It has three main fun):tions: '(1) to 
teach ffiodei^n statistical methods to students ^with- nsirlnal 
mathematical backgrounds; (2) to provide educational adainistiators 
and others with easily used, yet sophisticated methods of explqring 
data sets^^ a 
posterior p 

utilities in order to produce coherent and ^effective deci'sicus; and 
(3) to provide mathematically and statistically advanced persons with 
some powerful matrix' tools usieful in a .wide variety cf advanced 
applications.. The system is accessible to^stiidents and educators .who 
have ne computer experience. The CAtA leads a user tlrcugh a 
statistical .analysis on a *s1;ep-by-ste^ basis so that the user' must do 
things correctly- A further^ innovation of eAOA is the integrated 
tree-structure design of the system^ Data are passed automatically 
from one Module :of an analysis to another* This manual discusses 
design concepi:s.and' capabilities of 'the Monitor as a data analysis " 
system. (MP) ^ * ^ , 
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OVERVIEW 



The Computer-Assisted Data Analysis XCADA) Monitor is a convei^^ 
sational-language interactive computer software package intended for 
several audiences. Leading a user step by step through a dat^ analysis 
in much the same way as a computer-assisted instruction (CKl) program 
leads a student, CADA's first function is to teacl\ modem statistical 
loethods to students with minimal mathematical backgrounds. CADA's second 
function is to provide educational administrators and others with easily 
used, yet sophisticated methods oi exploring data sets, assessing 
utilities and prior prob^bifities, obtaining posterior probabilities, - 
and combining these probabilities and utilities in order to produce « 
coherent and effective decisions. The third function of CADA is to 
provide mathematically and statistically advanced persons with some ^ 
powerful matrix tools useful in a wide variety of advanced applications. 

The purpose of this manual is to describe the 1980 release of .the 
CADA Monitor. Earlier versions of the Monitor have been released 
beginning in 1973 (Novidk 1973; Isaacs and Novick, , 1976 ; Isaacs, DeKeyTel, 
and Novick, 1976^ Novick, Isaacs, and DeKeyfel, 1^77; Isaacs and Novlck, 
1978; Novlck, Hamer, and Chen, 1979). This 'mSnual discusses the design 
concepts and resulting capabilities of the Monitor as a data analysis 
system for lise on a wldfe range of computers". Whil-e this n^nual is riot 
strictly necessary for the operation of CAfiA, a user may be^Qme more 
familiar with the Monitor by consulting ItT 

\. 

* , The primary innovative fe;ature pf ' the CADA system is the presenta- 
tion of data analysis program^ in the conversational mode (written in ' 
Basic), thus making the system* accessible to students -and educators who 
have no computer experience. CADA* leads a user/through a statistical 
Analysis on a step-by-step basis so* that the user miSht "do things 
correctly". The CADA sysj:em makes use of the two major strengths of the 



computer — 'computational speed ^nd metnory — as adjuncts to the human 
thought process and makes these two capabilities more directly usable 
than' do othftr computing systems. . 

A fifrther innovation of CADA is the integrated 'tree-structure ' ^ ' 
design of the system. Data ate passed automaticaUy from one module of 
an analysis to ano'ther. .This design facilitates a high-level^f freedom 
'of moventent within a given analysis, so that sections of an analysis can 
be redone without the need to start from, the beginning. This is further 
facilitated by a sophisticated restart routine that gives the user a • 
high degree of pontrol over the analysis. Finally, the system is highly 
modularized so that new methods of analysis can be easily programmed 
using building blocks already available in the Monitor. 

The 1978 version of CADA was installed at more than 100 universities 
and research 'organizatiohs internationally. The 1980 version of the 
Monitor was released on Jund .1, 1980. 
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Caution 



The Coiis>uter-Assisted Data Analysis (CADA) Monitor (1980X was 
written and tested on ^ HP-200Q computer. It was then translated into 
other dialects of the Basic language for use on oth4r computer systems. 
It is unfortunate, but computer progrsfcrns are. seldom error-:free and^ 
translation undoubtedly introduces further problems. Extensive testing 
and error correctidn was performed for eath dialect of CADA. We believe 
that' CADA attains a high standard of accuracy. IBecause CADA is inter- 
active and tree-structured, however, it is not possible to completely 
test CADA by following every possible path through the tree; it would 
take an unacceptable amount of time. Users should pretest those portions 
of CADA that are to be used as the' basis for decision making. 

We would appreciate; being informed of any errors found. For this 
purpose a CADA Error Report Form is inclufled at the back of this manual. 
Please include a hardcopy printout ,of the error, con^ning the entire 
sequence' of events from the execution-of CADA to the^rror. Additionally, 
a listing of the program as it is implemented on your machine would be 
helpful. We shall attempt to correct all errors that come to our ^ 
attention and notify all members of the CADA Users Group of corrections 
that are relevant to their installations. - Neither the developers of CADA 
•nor The University of Iowa can accept any responsibility^ beyond that 
indicated above. ' . ^ , ' 
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I. INTRODUCTION 



.Many steps are involved in completing an informative statistical 
data analysis. Some are skilled tasks requiring the expertise of a 
substantive-area specialist; others lire purely mechanical. The former 
include such tasks as choice of a model, specification of a prior 
distribution, specification of a loss or utility function, and interpreta 
tioh of a posteri-ar distribution. The latter include such things as the 
operations necessary to summarize and display data, to combine the prior 
distribution with data to produ9e the posterior distribution, and to 
produce probability statements from that distribution.' 

Unfortunately, it is all too often the case that arithmetic gets in 
the way of the professional's decision-making responsibilities by 
breaking tbe concentration and train of thought. At times, the sheer 
bulk of the computations precludes the use of advanced techniques Tsy the 
unaided researcher. It is also true that good decision making requires 
the synthesis of many pieces of information at a critical decision point. 

In order to facilitate the goal of informed' data analysis for a wide 
range of usei^s a monitoring system is needed that does all of the arith- 
metric, stores and "then 4i^splays all necessary information at appropriate 
points, and, even further, guarantees that alf o£ the sfeeps in the" 
analysis are performed correctly and in their proper sequence.. This 
sequential guidance will be useful in teaching students by directing 
t^leir steps through valid statistical s^alyses even if they do not yet 
understand fully what they are doing. . It will also make- it possible for 
investigators with minimal statistical backgrounds to perform complex, 
statistical analyses with greatly reduced dependence on the tutelage of 
professional statisticians^ Furthermore, good decision making can be 
facilitated by the use of computer niemory to relieve demands on the 
investigator's memory. ^ ^ : ^ ' ^ 

^ Capitalizing on the capabilities of the computer to facilitate 
jeff^^tive decision making, a system for c6TH)uter-assisted data analysis 
(CA^A) has been undeT continuing development at The University of l^wa 
'since 1971 .(Novick, 1973). Through ongoing investigation into available 
computer technology, coupled with expansion of the theoretical base on 
which the original system was constructed, the listing of availsible 
analyses has been continually expanded and individual algorithms refined. 
The org'anization of CADA- through a Monitor system (Novick, 1973; Christ, 
1973; Isaacs and Novick, 1976; Novick, Jsaacs, and DeKeyrel, 1977; 
Isaacs and Novick, 1978; Noyiqk, Hamer, and Chen, 1979) realised the 
stated goals of the project;. TJie first major release of CADA was made 
in April 1976 under funding^ from the* National Science Foundation. 

Since CADA was meant for use both as an instructional tool and as -a 
research tool for general application, it was necessary to find the mdst 
effective means of facilitating wide distribution of the Monitor for use 
on Inany^ computing systems. Due to limitations available time,' 
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personnel, anti money, reprograiaming on a system-by-sy^tem basis was 
rejected as a feasible laetKod of impleoent^g C&DA. Since no entirely 
transportable language existed for all Interactive ^l^^J^^^lH,, 
mini- and tnlcrosystems) . it was decided to pursue a strategy that would 
permit interdialect translation rather than actual '^f f 8ramd^J._ v , 
Examination of available hardware and ^fware pointed- toward the Basic 
p^ograx-uing language as the only alterStiye for translatability across 
sever^Sufacturers. ^Isaacs (1972) demonstrated that programs written 
in one dialect of B^sic could easily be. translated into many oth^r 
dialects, provided certain specified constraints were observed in the 
initial programming. The > first Basic Implementation of CAD A was 
develSed by ?^cs and Christ for the CDC 3600. at The Uniyetsity of. 
•SachusetL in 1972 in the BASICX dialect, . This, was easily and quickly 
translated .into, the dialects for the Hewlett-Packard 2000 C and the 
DlStal Equipment Corporation PDP-11, thus validating the assertions made 
by'isracr(l972). Since then, the Monitor has -been f ^f^J^f ^^^rll 
many different machines ranging from microcomputers to the large, general 
purpose-, timesharing machines. Earlier releases of CADA have been 
installed on the following systems: 
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Microcomputers 

K DEC PDP - 11V03 RTll (1978 release) 

* WANG 2200 (1976 release) 

Minicomputers 

DEC PDP-11 RSTS (1976. 1977. 1978 releases) . 

PDP - 11 RTll (1978 release) ' 
HP 2000 (1976, 1977. 1978 releases) 

% 

' General Purpose . . . 

CDC CYBER NOS (1976, 197f, 1?78 rele^e^) ' 
IBM 370 VS (1977, 1978 releases) 
DEC PDP-10 TOPS-10 (1976 and 1977 releases) 
.. UNIVAC 1110 (1977 release) 

6^bes«-^chines have very different environments in which CADA bust run. 
I^IaDA has be.n designed ^^^^^^^l^^^':^^^^^^ 

Tthe TlX^^^^^ B^^K^1SIC-PLUS), XBM 370 (VS VSBASIC) , 

and- PRDIE JSO (PRIMOS BASIC) . 
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II. THE CdNVERSATIOML 'USEl^-MACHINE INTERFACE 



The way in which CADA^has been designed to interact with the user 
is based on several assumiltions that now, after several years of use in 
CADA, seem to have been validated. These assumptions are largely related 
to the way in which information is presented, to and processed by the user. 
It is first assumed that data analysts 'I^Wr be facilitated if the user ' 
nevqr has to rely on his. or memory. ^That is to say, at any given 
point In th6 analysis, the frame (simultaneous presentation of ,inforraa- . 
tion) that the user' sees must contain a^l information necessary for 
whatever decision must be made. Typi^cally, these decisions are very' 
simple ones; they may involve a quantitative evaluatiot^^ or an indication 
of which branch the user Vishes to take. In each case careful thdught 
must be given to precisely what the user might want to know in making 
that decision. ' ! r 

Second, it vas decided that the < same system should be made available 
to all users regardless of their lev&l" of abilft^. This approach differs 
from that taken iiT^gSfifet^-sy^ems. that have the capability of providing 
various leyels of prompt r5t users ^ with different levels of familiarity 
with the system. -We have decided to use a jingle mode df presentation, 
having judged that it is difficult for even the user^to know precisely 
what level of prompt may be needed at a given time.' Thus, a user may be 
quite sophisticated but may have a lapse at a particular point and want 
additional information. - ' - 

In orderr to make this system feasible without losing the interest 
of jfhe experienced user by requiring the reading of redundant material, 
it'bas been necessary to put great emphasis on formatted ag4 optional , 
output. On the CADA Monitor the -formatted output ts -done ^n such a way 
as to^ segregate information that is minimally sufficient for the 
experienced user from information that the less experienced user may, need. 
Thus, the experienced user is able, because of CADA's carefully formatted 
design, to pick out what is needed by reading on^y a number or two, or' 
perhaps a line or two, while ignoring blocks of text that will be 
important to other users. In many cases an explanation may be skipped 
by simply indicating it is not wanted. However, if the user at a later 
time wants the explanation, it is still available. 

/ ^ J 

Our approach does involve the transfer or large -amounts of informa- 
tion for 6ach frame. Therefore, it becomes. desirable that a minimum baud 
rate of 1200 (appro:a.mately 120 characters a second) be available so that 
the user will not be fatigued while using CADA. This makes the use of 
older hardcopy devices, such as the teletype, undesirable. This does v 
9€lll leave open' the possibility of using dial-up facilities. While we 
sometimes use CADA with 300 baud output devices over phone lines, we 
find that usere may become somewhat fatigued during lengthy sessions. 



With the advances mow being made in computer technology, relatively 
inexpensive equipment capable of operating at 1200 baud. are now available. 
There are now several hardcopy devices on the market that operate at 1200 
baud',, including the GE Terminet and. Decwriter Model III. ■ ' Accoustic 
couplers are now avai&ble which operate at 1200 baud °y"/^^^P^?"M/ - 
lines and facilities for their use are becoming increasingly available. 

The third assumption made in the design of CADA is that it is 
irtportant in the conversational user-machine "interface for the expert to . 
be able .to enter an analysis at 'any point. For example, an expert, or 
indeed any user who knows precisely his or her P^ior distribution and 
therefore does not need help in this part of the analysis, could enter 
the analysis at the preposterior or posterior-distribution point. ^ ^ 

Because the prior distribution module was not executed, the parameters 
of the prior distribution would not be available in the user s personal 
file. The Monitor is programmed to check for this, and if all "^f 
in o;mai5on is not available, the Wtor will ask- the user to -ter t^ s 
information, which presumably the user can then supply. ^^^j^f 
has the ability to let the user go back to any previous point in the 
analysis and redo the analysis from that point, reread the explanation, . 
rie^iL Sharhas previously been displayed, while keeping all in orma- 
?ion and computations thatwere settled on in previous steps. In design 
tog package as we have^tt4l,as been our. intent to give the user the 
fefung that the computer is working for the user, rather than that the 
user S working for the computer. The user should feel at ease working 
. with the package. 

The fourth assumption is that important user input should always be 
numerical "Ss-no ^tchUng is done by 1-0 coding. '-^^^ft^f^^lllZi 
Sl^ric^lly as scalars or vectors. The primary advantage o^ this ^proach 
is the ease of user input. A secondary advantage is that CADA can be run 
w^t^ve^ inexpensive user. terminals (currently costing under $7qO) ana 
fndeed SeieXuld be little difficulty in using ^ABA with twe ve key 
telephone-type keyboard as an input device and a mpdified TV set as 
display. A further detailed discussion of these properties of CADA is 
given in section IV# 

I . 
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III. THE FUNCTION OF CADA IN THE UNIVERSITY 

• >' ^ ' . . 

One of the primary uses of the CADA Monitor is a supplement for 
instruction in statistical methods courses takea. by* students in various 
disciplines. Students can learn most easily by doing, ar^ the CADA Monitor 
facilitates this ^approach in the teaching of. s tat is tics. H/f he Monitor also 
promotes the effective teaching of applied^ »^nd mathematlca^l statistics to 
statistics students. ^ ' ( 

* Any prograip of instruction in statistics will involve the familiariza- 
tion of the student with various standard statistical distributions, 
including normal, t, chi-rsquare, and F dfstributions. Students can gain 
an understanding of these' dist^ilj^ytions by using the Monitor to compute 
characteristics and to display^^graphs of them. Students can do simple 
numerical exercfses much moi^e quickly by usii\g the Monitor than by using 
the books ^f tables, and therefore students can do more such examples in 
a given period of time. t^It should be noted that the current version of * 
the Monitor begins to make available the computation of various robust' 
statistics in addition to the usual sufficient statistics under normal law 

assumption. '^i^ 

* ^ 

Further, the Monitor has the capability for the entry, editing, and 
storage of new data sets and provides some catalogued data sets for the 
student. These may be us^ed in connection with set computational problems. 
The Monitor ^Iso'has a capability for grouping, transfonniilg, and re- 
grouping observations so that fresh data sets can alvjays be constructed. * 
This is of' great asi^stance to students performing exploratory data 
analyses ^.njthat it gives them a "feel" for the data. 

A component gyoup that instructs investigators in exploratory data 
analysis. (EDA) is available. CADA now provides both bivariate and^ 
undvariate EDA^ The investigator is instructed on -how an EDA analysis may 
be.perfoisi^d; the investigator is also provided with the necessary tools 
to Jook at univariate and bivariate data. Thus, CADA aids the investigator 
in de-vfieloping a description of data. . ' * 

' * Two further,^ related functions of the CADA Monitor within the 
xmiversity have been developed. Informal consultation between substantive 
wojrkers and those associated with the CADA project have, in several 
instances, resulted in these workers doing more stais factory, in-depth 
analyses of their data. The fact that the Monitor makes it ppssible fo^, 
such persons to do this work with only minimal guidance from the consultant 
is beneficial in two respects. First, the consultant spends time only on 
those activities that make the best use of the consultant's skills. • 
Second, the investigator works independently and thus ends up with a far ^ 
greater "feel" for results and conclusions than if the work were done by ' 
others. 

f 
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As a 'result of the experience gained to date with the consulting 
function of the Monitor, it is suggested that the Monitor could be used 
as a central tool in a university, statisitical consulting center The 
method of operation would be ver/similar, to that used in teaching the ^ 
Bavesian statistics course with the -Monitor. Substantive workers with 
sStistLal problems would consult with consulting.center s/aff members, . 
eifwou "L^^^ design the study, suggest ^PP'^^f ^^^^ J^^^.^e'^^- . 
niques. and get the investigator started in using, Monitor The 
.investigator would be responsible , for preparing an ^"^5^^^ "^^^^ "^^f 
project! Which would be.reviewed by the ' „f ^ Ser completing 

•Sould then do the analysis -^^.h, the a d o the Mon tor After c^^^^^^ 

Tdricrs rergiitdTh^tL^:^^^ ^^^i^^rTi^^^^^^^^^ 

benefited as much as. possible from this particular ^^^P.f ^""• 

I^■^s to be expected that, initially. .appropriate methods would not be 
jia lable L Se Monitor for many of the problems ^^f S^^'^'^^/^ri^^;"^ 
♦benter. However, the demands - on the -f^^^/^^^.f "^ifi^JiLfalTork is 
guide- for further development of the Monitor. This 'i^y^^"?"^" 
cu"entl5 in progress at The University of ^LSsut s5°aas icaf 
Professor George Woodworth, Director, of the. University Statistical 

Consulting Center. 

•A second possible fu,<;tlon of CADA ""''i" J^iL'Jhrt' " 

persons m mathematical statistics to see new ^^^^^^'^j'^h' cADA 

. ri^Lii^i r'irritrr Ve^r sr corutSrsS'toutine, 

'"^'avSaUe'^LfS^yTe -ek "bulldlS'blocL fo'r the construction of 
Z ZtlT S:ieTubro„tlnes provide. ^•'^"^.^X" Son "for 

Ilem^ntary matrix operations, for the standardization of a matrix, for 
.^Zyo(^ ra^\r^?hfrc^rie^cSrrru?fn2 tTe~rone^ " 

vectors calculat ons. and a^^^^^^^ "atmical routines. With 

that will be useful e^sy for p.ersons with only modest 

these available, it will be reiacivexy /"^^ ^ mnatruct conversational 
computer abilities in writing programs in. Basic to construct conv 
■ algorithms for inclusion in tKe CADA Monitor. ^ 



IV. DESIGN CONSIDERATIONS FOR THE MONITOR 

w 

• The current Monitor was developed based on seven design considera- 
tions or rules. These are as follows: 

1. The user is not required to have aily programming sjcills. This 
was perhaps the most important consideration of all. Although possibly 
highly skilled in a particular subject area, the user may be quite 
unsophisticated in terms of computer skills. Therefore, user interaction 
must be kept as -simple as possible. With CADA, the user need- know only 
three system-related commands: 

.1. how to sign on the system; 

2. how to start the Monitor running; 

3. how to sign off the system. 

2. The Monitor must be self-doctimenting in terms of the options I 
available. "The Monitor should be modifiable to include new models, neU 
techniques, and improvements in current programs, without the user having 
to search out the latest "-news letter"- or update sheet. As noted in the 
Introduction, while this manual provides background information, it is not 
essential to the use of the Monitor. 

9 

3. The user should not be "left hanging" by the computer. If an 
invalid response is given by the user or a niimerical^integration fails to 
converge, an error message foll^ed by a halt to the program is not . 
adequate. The program must give the unsophisticated user. enough informa- 
tion so that^he or she can proceed. Furthermore, whenever possible, input 
from the user must be checked for validity to avoid system errors such as 
dividing by zero or taking the root of a negative number. In the CADA 
Monitor, when an unforeseen error occurs, the system chains to a routine 
in which the user is told to save the output for use by the person main- 
taining the system and then returns to the Monitor to continue the session 

4. The fourth design rule is J'branchability", which enables the 
sophisticated user to determine a path through an analysis'. In the CADA--. 
Monitor this is accomplished through the use of a four-level (component 
group, component, model, andsjnodule) tree structure and a "restart" 
facility. The user is allowed the option of terminating one part of the 

'analysis at any point and choosing the point at which to "restart" -the 

analysis. Whenever input is requested, the user toy. type "-9999" and^ 
enter the restart routine (RSTRT) . Each user has a personal file that 

, contains the data being. used and all critical values computed for this 
user by CADA. An initiated restart permits the user to reenter the 
analysis at ^several earlier points with all necessary values retained in 
the individual's personal file, x 



^S^^^he fifth central design strategy of the CADA' Monitor is 
-^mn^aktv Whenever a statistical routine is constructed, the required 
r-e ;roSrd::^ Lo -logical steps that are P-fa-^/^-in ' 
•as building blocks to be used in "the present program and possibly in 
fu^u^e programs. 'Thus, after nine years of development, an organized and 
c^Slogued'cri;ction subroutines has been established, any member of ■ 

whici can b-. appended during program --"-J^^' .^^.^^^ so'obvious. 
gratnming time is obvious. However, a second benefit ma y not be so oby ious. 

Numerical analysis techniques have improved, subst^ially durinTthe ^ _ 
past decade, and further significant improvements will be fo^^^hcomlng. . 
Because CADA is so highly modularized. ^ich if is used, 

block subroutine automatically benefits all programs ^^J'^^^^f^/^^^'^^g. 
with little or no additional labor being required to modify these program 

§> ' ' • 

A Tho s^vt■h design strategy of CADA is a specific approach to 
.eadaJmI^^r^:l^eve is cor^^^^^^^ one in this -te^t^ ^^^^^^ ' 

rr^s^ritt^to rx^T^^o. iiz^:^^oZ --g co.u^-- 

^ ion available to locations with minimal capital resources, and providing 
tiS cipability to institutions having. a wide variety °f /°'°P"'^«'^„„^„ 
hardware includSg those having only minicomputers or microprocessors. 

:n«rrts.^L=^^^^^^^^^^ ^^^^^^ 

■'portions of the^user'^s resources are necessary to support this type 
user response. 

r ,^ A second common approach that we l^ve not adored i-olves -king 
^ available two or three levels of ^/-J"^\-'^°'"?^",f:"!;,fr^si?^ 

pr^speci^ied l-l;f expertise ll f l^^Z^,,'^^^^^ own^r^al ^ 

. techiUea'coSinL^d us of our inaMlity t j ^ Just o 

text is necessary for each J-^*^^"" Led for help among 

We also found that there is much variability in neea ror v 
Ler;. Our solution to the problem, therefore !s t° P-^-^^^iJ^ 
Screen of information when asking a question ^ ^^-^^ ^Lded without 
formatted so that the expert can P^^ J^^i^f.^^'^e^^pposes fast , 
reading everything oh the screen This, of / ^^^^5 ^^^h mini^- 



cente'r. 

lA 



The University of Iowa have been very helpful in this regard. 

(With respect to charges, a brief parenthetical remark might be 
added. For CADA, the concept of economy of scale in selecting- a computer 
is fallacious. For CADA, the larger the computer', the greater the cost. 
Use of a CDC CYBER might average out^ to an all-inclusive charge of $10 or 
more an hour for CADA, whereas use of an LSI-11 based microprocessor 
might be $1. Either figure, however, represents aii incredible bargain. 
Users of CADA should discuss pricing policies with their computer center. 

-JThe unusual mix of computer component usage in CADA should ^itvite 

, reconsideration of component charges.) 

Regardless of what approadh is taken to readability, we believe that 
the central concept should be reliance on the memory of the computer, not 
that of the usftr. As Sherloqk Holmes pointed out,, brain cells used to 
retain facts c^n not be used to process information* Indeed, the great 
virtue *of the computer is that it can store facts and retrieve th^m 
instantaneously, thus freeing the mind to think. CADA is organized to 
emphasize fully the use of this strength of the computers 

7. The seventl? design strategy for CADA involves transportability 
^ and translatability, which will be discussed in the next section. 
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V. TRANSPORTABILITY AND TRANSLATABILITY : 

SOME CONSIDERATIONS AND PROBLEMS ' 

The most iTnpoftant development in the computer industry during 
recent yeara'has been the rapid decrease in the cost of computers. This 
is true of central processors, memory, mass storage, peripherals, and 
terminals. The priceZ-performancq ratip of hardware has improved by a 
factor of 100 each decade since 1955, and indicatioas are that this will 
continue at ifeast for the next decade (Comput^rworld , August 8, 1977, 
p. 1)> As a result of this trend, a purchaser^ of today's computer hard- 
ware can buy more than three times as much power, for one-third the" price 
o*f a computer five' years ago. 

While the cost of hardware has dropped dramatically, the cost of 
computer software has riaen substantially over the past few years and 
will continue to do so in the future. This is especially true in the 
area of minicomputers and microprocessors, where new software is needed 
•and must currently be amortized over a small base. With the increasing ^ 
pow^r and capabilities of .minicom-puters and microprocessors, there is a 
growing demand for. new packagesj. which/ has not been met by software houses. 
In order that the gains in thelardwa/e capability, particularly in 
microprocessors, be effectively trafi^lated into all-around increased 
computer effectiveness, the need for software packages must, be met, and 
at a reasonable cost. ' . 

One means of counteracting the shortage and high cost of software is , 
for users to pool and share their packages. Most hardware manufacturers 
have formed users groups, and in the educational context there is CONDUIT, 
based at The University of Iowa, whose purpose is to distribute computer 
software. In order that software be shared by many users, however. It 
must be transportable. This means that it must be written in a language 
that is supported on a wide variety of machines and that is compatible 
from machine to machine; Currently, the only language that fills these 
requirements is Basic. Unfortunately, the situation is complicated by 
the fact that. Basic has many dialects that differ in both syntax and 
semantics. Different machines from the same manufacturer may not even 
use the same dialeaf of Basic. • . 

The CADA monitor is currently developed on a Hewlett-Packard IJP.ZOOO.. 
system in the Basic eprogramming language; however, only a subset of the ^ 
HP Basic is used\ As shown in "interdialect Translatability of the Basic 
Programming Language" (Isaac's, 1974) and "Basic Revisited" Isaacs, 1976), 
programs written, 4^ one dialect of Basic ^ be easily translated to another 
dialect if a few siniple rules are followed. Following these ^ guidelines , 
translation of CADA frok the' HP 2000 dialect to several dif f erent dialec^t^s 
is straightforward. The 1977 release of CADA contained 5J"i°"^_^°%"^\o, 
on the following .computing systems: HP 2000 Basic. DEC^DP-11. DEC^PDP-10, 
IBM 370(VS). CDC CYBER, UNIVAC 1100. The 1976 release had also^^contained 
a WANG 2200 version. The 1978 release had been made for ^he following 
systems- HP 2000 Basic, CDC CYBER (NOS, BASIC). DEC PDP 11V09 (RTll. 
Esfc , DEC PDP-11 (RSTS, BASIC-PLUS), and IBM 37.0 (VS. VSBASIC)^ The 
1980- version of CADA has been released for the ^J^Pf ^ 2°°° 

Basic, 'PRIME 456 and up (PRIMOS, BASIC and BASICV) . DEC PDP-11 (RSTS, 
•BASIC-PLUS), and IBM 370 (VS, VSBASIC) . 

i3 ^ 
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•Many statements that were used in the HP 2000 version translated 
directly across all dialects with no changes necessary. For example, 
GOTO, FOR, GOSUB, REM, and NEXT statements translated witKodt change. 
Other statanents were changed only if they had string or substring 
references*' This modification varied from dialect to dialect but was 
accomplished under program control, ♦Examples of, this type of statement 
are LET, IF, PRINT, and DIM. Other statement* such as GOTO-rOF (ON^GOTO), 
and CHAIN, only needed a change in syntax fromvdialect to dialect. State 
raents involving formatted output and file input and output required 
•extensive change, but were Jiandled uqder program^ control across^ dialects. 
Therefore, only a limited set ot options was allowed in the HP implementa 
tion of CADA. ' ' . * 

The first step in planning for progr.ams that could te translated 
from one system to another took place during the design phase. At that 
time it was decided what caf>abilities of the computer were necessary for 
CADA. It was decided that the following were necessary for a conversa- 
tional, modularized package such as CADA: 

1. Program chaining 

2. External files 

3. Retention of a personal file name* across a chain 

4. Formatted output 

5. Limited string handling (substring, length, conversion) 
* 6. Minimum of six digits of accuracy a 

The. rules for translatability were then checked so that only the most 
translatable forms of statements were used'. For example, only 4.nteger 
expressions were allowed to appear as a subscript of an array. ^ This 
avoided the problem that some systems round the subscript while other 
systems truncate it. , . , 

Th^ next step in planning for translation was to compile a list of 
statements used in the HP impleme^ntation. of CADA that needed translation 
to the different dialects. These were kept to a minimum, since only a 
subset of the HP Basi6 sta^tements were used. The following* statements 
were modified for each trdnslation: 

PRINT # ^ -6. CONVERT 

READjJf ..* ^. string jiimensions 

PRINT USING 8. string functions 

IMAGE (output format) '9. COM 

• GO TO ... OF 10. CHAIN - 

translator program was written for each dialect of Basic for which 
an Implementation of CADA was to be produced* These programs resided oji 
a "PRIME 750 system. They modified the necessary lines of each mo4ule and 
produced an ASCII file that contained the translated, programs. ThisXASCII 
file was then copied to magnetic tape on our PRIME 750. Each module 
CADA was a separate file on the tape. 
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The translator prograns ^handled about 99 percent of the statements, 
but some statements still had to be translated manually • The 1 percent 
that were not automatically translate were thp^.e that occurred very 
rarely and were easier to fix by hand *han to make a "special check for them 
in 'the translator* These occurred mostly in the control programs. ^ 

Data files to be transferred were written info ASCII files, one entry 
per record , ^nd copied to a magnetic tape. These were then read by a small 
program written on the new irfachine and written out by the same .program in 
the appropriate format for the nev machine. . ^ / 

After translation, CADA was then thoroughly tested on the new machine 
to ensure that no errors had been introduced during the translation. Th^/s^ 
testing phase took several days. A tape of the modules and files was then 
created using the method that would facilitate the transfer of CADA to 
other ihachines of the same type and operating system. ^ There were usually 
programs provided by the machine vendor which allowed easy transfer from 
one storage. medium to another. These allowed all of tABA to be loaded 
from tape with a few simple commands. If a ^vendor-supplied program was 
not available, the easiest and most, straightforward means was xiocumented 
and sent to anyone receiving CADA. . ^ ^ * 

It should be noted that there is an American National. Standards 
Institute (ANSI) committer X3J2 tfiat has been commissioned to standardize 
the Basic programming language. It has been meeting for over six years 
and has prpduced ANSI standard minimal Basic. This is a small nucleus 
from which 'extensions will be produced that will standardize enhancements. 
Minimal Basic contains only the following statements: DATA, DEF, DIM, END, 
FOR, .GOTO, GOSDB, IF, INPUT, LET, NEXT, ON, OPTION, PRINT, RANDOMIZE, READ, 
RIM, RESTORE, RETURN, and STOP. The following implementation-supplied 
functions wer4 also standardized: ABS, "ATN, COS, EXP, INT, LOG, RND, SGN, 
SIN, SQR, TAB, and TAN. * More importantly, minimal Basic sets down syntax 
and semantics that are to be followed, in future 3asic dialects. The 
.committee is now working on LeveJ^ enljancements to ANSI standard minimal 
Basic and plans to have these comflleted late in 1980. -CADA has been 
developed In a manner Consistent »with the restrictions of the proposed 
Level l^enhancanenta. When and if iLev^l I Basic is standardized and 
adopted by all manufacturers, translation will no longer be necessary for ^ 
CADA. But even an optimistic estimate -wotjld put that at least two pr 
thxee yeirs into the future. — * 

• / Eadh dialect* of Basic has it own Sto^ntics and syntax 'that limit 
What can be prpgrammed in that dialect. NWhen^ programming for translat- 
ability across several systems, the constraints become somewhat more 
/demanding and at times precludfiL the 4ise of features that may be present ^ 
^ on one system only or that differ radically txom one system to the next . 
This consideration, taken in conjunction with the seven design riiles 
mentioned •previously, has governed most of the -dti^ign of- the Monitor and ^ 
its programs. 



An inportant feature of the Mpnit^r is that user input is screened 
for validity. If the user were aUpwed to enter responses as character 
Input, a parser would have been necessary to allow for misspellings and . 
synonyms. Also, since the strirfg-handling. capability ^Is not highly 
developed in all- B^siq dialects and the handling of a finite set of 
responses can be doneiby much simpler coding, user responses to questions 
within the program segments have been forced to numeric form. Our decision 
to forego the extensive use of strings thus greatly enhanced the translat- 
ability^^f the system,^ . - 

While the latent version of the Monitor was designed on a Hewlett- 
Packard 2000 system, an attempt has been made^ to minimize the dependence 
on featuY^s not available in most Basic dialects for other systems. As 
ttentioned .earlier, there are several features that have been used on the 
Monitor- that maybe somewhat limiting. These* are: t * 
r 

1. Program chaining 

2. External files 

3. Retention of a personal, file name across a chain 

4. Formatted output.^ 

5. « Termlftals 

1, Program Chaining ' 

Chaining is central to the logical design of the CADA sys^tem, since 
one of the cornerstones is* that the user need know how to sign on but 
need not know the names of the individual modules. This necessitates * ^ 
either a main routine-subroutine system or a Monitor prograj that directs 
the loading and execution of the proper module'. While the main routine- 
subroutine system would have had the advantage of ease of parameter 
^passing, the number of paraiaeters to .be passed in our system is. few, and 
the values can easily be stored lit files and thus passed from one module 
to, another. In addition, Jthis structure ie not translatable. The strategy 
of designing special master program^. (CMONTR and CMPGRP) was therefore 
chosen, since this best suited most B^sic programs. 

The . chaining strategy used in CADA has' several advantages. First, ^ 
only the module in use need be stored in the computer memory, thus 
'^reducing system overhead. Second, th6 system could be expanded with little 

effort on the part of a programmer and with no operational change visibL 
•to the user. , , ^ 

' — . -^^ ^ . . ^ 

2. . External Files " ^ * * , - 

A file capability is needed to wpport the chaining strategy and to 
allow the restart feature. Sdnce the user jumps from module to module in -r^. 
the course of an analysis, the CADA, system must "know" with which analyaia 
and module the user is working. This Information is stored in the user*8 *. , 
personal file along with any data that are needed in upcoming modules. 
Most Basic systems have a file capability; the Monitor uses a random access 
capability. This may be^changed easily .to sequential access by using 
different files for each of the randqm-access entry points (see section XHI) 
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3. Retention of a ?ersonal File Name Across a Chain 

The capability for multiple users of -the 'system creates the need for 
a separate personal file for each active^ser. Thus the system always has 
to know which user is' associated with which personal file: This presents 
a problem because a CHAIU destroys the values of all variables. On the 
HP-2000 system this problem .is- overcome by means of a COMMON statem^nt, 
although other systems use different means. For example, this can be 
accomplished on a DE^ PDP-11 by use of core common. Other systems use 
file^ that. are temporary and uniquelfp a terminal session. If there is no 
need for multiple users on the system, this capability need not be present. 

4. Formatted Output 

Formatted print statements are used to present information in a 
significant and visually-pleasing way. This is not necessary, per se, but 
is desirable, since the intended user is presumed to be not a computer ^ | 

expert, and therefore- the user-machin^nteraction should be facilitated 
in every way possible. The formatted. print statements and associated 
im^rstatements do )^ve analogues in every dialect to which we trahslate'; 
however, there will be some change from machine to machine. 

5. Terminals . • .. 

The CADA Monitor can be used with a variety of .teletype-compatible 
cathode-ray-tube terminals. To present information in a visually-pleasing 
manner, it is useful to erase the screen between frames when this is ^ ^ 
possible. Because each kind of terminal has a unique coding for the / 
function of screen erase, it is necessary for the computer to ask the 
user to indicate which kind of terminal he or she is -using. This is done 
With' a multipleffchoice-format question that includes an "other CRT option. 
The approprfate^ode to be sent to, the terminal is passed from module to 
module with the personal file name. The following terminals are now 
supported by CADA: ^ . , 

1. Beehive * 

2. ADDS or Hazeltine 

3. . Super Beehive • ' 
' A. Hewlett-Packard 2640 

5^ Tektronix 

, 6. Infoton and VISTAR 

7. Lear-Siegler ADM-31 • 

8. Imlac PDS IG or Plato Plasma Tube 

9. DECwriter III (LA120) 

10. Other CRTs (a user specified code is used). ^ • 

11. Othe- hardcopy terminals: Decwriter II, Texas Instruments Silent 
7:0s, Terminets, teletypes, and all other hardcopy terminals 
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Figure 1 

Flow Structure of the CADA Monitor 
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All itfodules and COMPnn 's may chain to CERROR, RSTRT, and CMONTR. 
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Supervisory Routines ' I 

There are six supervisory modules that monitor the presentation of 
inere are ^/^ J' [ ^ ^ for each component to control 

the components to the user, piub a muuuxc , fniinulnp Is a 

the presentation of the modules in the coiiponent. The following i« 
list^g and brief explanation of the function of each routine. 

1. CADA - Initializes the Monitor, chooses and initializes the 

user's personal file, sets the ^"^^""f ^^^^^^^'^'^f^^"" • 
the user'-s terminal, and passes control to CEXPLN an 
explanation is desired) or to CMPGRP (if no explanation is 
desired) . 

2. CEXPLN - Gives a brief Explanation of the structure and work- 
ings ol CADA and passes control to CMPGRP. 

3. .CMPGRP - Controls the selection .of the component gr/jup and the 

component <7ithin the component group. 

4 ' CMONTR - Controls movement between modules and between levels 
* of the tree structure, especially during a restart. 

• 5. RSTRT - called whenever the user enters '--gggS" ^"f "^f^^^ 
that a restart is desiiii^d. RSTRT a^ks the user for the- level 
. • at which to restart, sets the restart values in the personal 
file, and passes control to CMONTR. 

6. CERReft^ Called whenever a CADA Program «"'^°"f ^"/^^"^'J 
unforeseen errors, primarily when the personal file cannot 

be accessed. 

7 COMPxx - Cotitrols Activity for component xx. Each component 
' haf rcontroller that monitors the selection of the model. 

Eic planation of Levels in t he CADA System 

There a^e four distinct levels in the ^"-'^^-f l^Tis 

^1 :tfSfltVl time. A list of the component groups 



follows: 



Component Group 1. Data Management Facility 

Component Group 2. Simple. Bayesian. Paramettic Models 

Component Group 7. Elementary Classical Statistics 

Component Group 8. Exploratory Data Analysis 

Component Group 9. Probability Distributions . 
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Each component group consists of a number of related component . 



' on- 



This allows portions of CADA to be kept Mailable on a fixed d-f.sk 
line) or floppy disk while the- reminder of the system ts stored on 
^a magnetic tape or other removable (off-line) median. When one of 
these stored ccmponenb groups is needed, it can be made averlable to 
the system by retrieval from the off-line medium. This allcws'OT-line 
storage for CADA to »be kept at a minimum. The ccmbinatioti of 
Component Group 9 with any other coipponent group provides ^ 
capabilities for both component groups. Component Group 9 c^an also 
be used alone. The modules and data files necessary for each component 
group are listed in section VIII. 

The following is a listing of the component' groups and ^the 24 
components .that are currently availably with the models available 
under each component. ' . v 



Component Group 1. 

Component 12. 
Model 1- 
Model 2- 
' Component 13, 
Model 1- 
Model 2. 
Model 3. 

Component 14. 
Model 3. 



Data Management Facility 
Data Movement (InpXit /Output, Editing) 
Data Entry and Transfers • 
Data Display and Editing 
Data Transformations 
Nullary, Unary, and Binary Op^ratipns 
Sufficient Statistics 
^^atrix Operations 
^ile Maintenance 
File Sorting (Data Group'5'ng) 



Component Grpup 2, 
Component 21, 

Model 1. 

Model 2. 

Model 3. 
Component 22. 

Model 1. 

Model 2. 

Model 3. 
Component 23^ 

Model 1.' 
Component 24. 

Model 1. 
Component 25. 

Model 1. 

Model 2. 



Simple BaJ^esian Parametric Models 

Binary Models «^ 

Beta-Binomial Model » 

Beta-Pascal Model 

Comparison of^Two Proportions 

Univariate Normal Models 

Two-Parameter ^Normal (Natural Conjugate 

Priors) 

Comparison of Two Normal Means 
Comparison of Two Standard. Deviations ^ 
Mu It icat egory||foael s 
Multinomial Model (Dirichlet Prior) 
Simple Linear Regression Analysis ' 
Sijnple Linear^ Regression Model 
Multiple Linear Regression' Analysis 
Noninf ormative Priori^ ^ j 
Informative priors 



Component Group 3. 
Component 31. 
Model 1. 
Model 2. 



Decision Theoretic Models 
U^:ilities and Expected Utilities 
Assessment of Utilities 
Evaluation of Utilities 
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Component 32 • 

Model 1. 

Model 2. 
Component 33. 

Model 1. 

Model 2. 

Component Group 4. 
Component 41. 

' Model 1. 
Component 42. 

Model 1. 
Component 43., 
Model 1. 

Component Group 5. 
jComponent 51. 

Component 52. 



Compoig^ent Group 6. 
Component 61. 
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Component Group 7. 
Component 71. 

Model 1. 
•Model 2. 
Component 72. 

Model 1. 
Component 73. 

'Model 1. 

Model 2. 
Component 74. 

Model 1. 

Component Group 8. 
Component 81. 

Model 1. 
Component 82. 
. - ' Model 1. 

Cp:apon6nt Group 9. 
* Component 91. 



Educational and Employment Selection 
Quota-Free Selection (One Group) 
Restricted Selection (Two Groups) 
Selection of Educational Treatment* 
Assignment with Threshold Utilities 
Assignment with Conditional Utilities 

^ayesian Simultaneous Estimation 
Simultaneous Estimation of Proportions 
Arcsine Transformation 
Simultaneous Estimation of Means 
Equal Within-Group Variances 
Simultaneous Prediction in A-Groups 
Equal Slopes 

Bayesian Full-Ran^ Analysis of Variance 
Full-Rank Model I factorial Analysis of 
Variance 

Bayesian Analysi'S of Repeated-Measures 
Designs 

Bayesian Full-Rank Multivariate Analysis 
Bayesian Full-Rank Multivariate Analysis of 
Variance 

Elemenatry Classical Statistics^ 
Frequency Distributions 
Absolute-Frequency Histograms 
Contingency and Expectancy Tables 
Summary Statistics 
Summary Statistics 
Graphic Displays 
Absolute-Frequency Histograms 
Bivariate Plots ^ 
Regression 

Simple Multiple Linear Regression 

'' ^ 
Exploratory Data Analysis 

Univariate Exploratory Data Analysis 

Regular CRT Applications 

Bivariate Exploratory Data Analysis 

Regular CRT Applications 



Probability Distributions 

Evaluation of Probability Distributions 



Each component and model is described in detail in section Vl4 




VI. MONITOR CONTENTS: DESCRIPTION OF MODULES WITHI^J MODELS 

- ' ' A 

WITHIN COMPONENTS WITHIN COMPONENT GROUPS - 

COMPONENT GROUP 1 Data Management Facility 

Component 11 (COMPIl) Data^ Structures - ' 
(not' yet implemented) 

Component 12 (C0MP12) Data Movement 

This program controls the activity of Component 12, 

Model 1 Data Entry and Transfers 

. This model allows data to be entered into the 
personal file from the terminal, or Jtransf erred 
between the personal file and certain disk files 
defined by the CADA system. There is a catalog 
of data sets, stored in disk files, that are 
' accessible as well. The data set m^y be uni- 

variate or multivariate (maximum of 5 data • 
elements), and it may be ungrouped or grouped 
(maximum of 12 groups). There may be a maximum 
of 1000 total values in the data set. 

Module 1 (CMQDll)*^ Data Entry from the Terminal 

This module allows the user to enter small data 
sets from a terminal. * The data are placed in the 
personal file where they are made avai-lable for 
further analysis. The data may be edited as they . 
are entered. 



Module 2 



(CM0D31) Data Transfer from Disk 

This module allows the user to transfer data' from 
. disk files (DFILxx) vto the personal file. These 
data have been previously saved and given a data- 
set name by which the data can be identified. • 
' The disk files are part of the CADA system and 
are identified by passwdrds. 



Module 3 - (CM0D18) Data Transfer from the Catalog 

This module allows the user to transfer data from 
one of the catalogued data sets to the personal 
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file. The catalogued data sets are: 

Data set #1:' Iowa Tests of Basic Skills (ITBS) 
School #1 

* 

These data, which are stored in disk file FILEl, - 
are part of the data analyzed by Shlgemasu (1976). 
The file contains 51 observations on five data 
elements (sex. iid ITBS scores on vocabulary*, 
reading, arithmetic skills, ^d composite). 

Data set #2: Iowa Tests of Basic Skills (ITBS) 
School #14: 

These data, which are stored in disk^'file P1LE2, • 
are part of the data analyzed by Shigemasu (1976), 
The file contains 5l observations on five data 
elements (sex and ITBS scores on vocabulary, 
reading, arithmetic skills, and composite). 

Data sfet #3: Emergency School AjLd Act (ESAA) 
Pilot Prograip Data 

These data, which ar3 stored in disk file FILE3, 
are part of the data analyzed by SyBtem Develop- 
ment Corporation (Wang, Novlck, Isaacs, and 
Ozetftve, 1977). There are five data elements 
(treatment or control, math pretest, math posttest 
reading pretest, and reading posttest). 

Data set #4: Iowa County Data 

This set is data on the 9^ counties in Iowa. 
There are four data elepients: , population, area, 
median' income, and median number of school years 
completed (Isaacs, 1978) ♦ These data are stored 
on FItE4. 

Data set #5; Sample Regression Data 

These dara are stored in^ disk file FILES. Twenty- 
• five observations from each of the ten schools of 
the 1968 junior college data (Novick, Jackson, 
Thayer, and Cole, 1972) were selected on the 
following data elements: English, mathematics, 
natural science, and GPA, 
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Data set //6: Sample ANOVA Data 

These data were taken from Johnson and Leone 
(1964). There are 48 observations on 3 data 
elements (type of adhesive, curing pressure, and 
bonding strength)* 

Dkta set //7: Sample MANOVA Data 

These data were taken from an experiment on 
communication (Be^l, 1974) There are two 
between-subjects factors (substantive , content 
.and affective.- content of stimulus) and one within- 
subjects factor (^round). Responses in the exper-. 
iment were rated on three scales (substantive 
content, affective content, and meta-discussional 
content -of response). The data set is in the form 
of summary statistics and thus is only appropriate 
as an' example for the multivariate analysis of 
variance component. 

Data set //8: Data from Junior Colleges 

Tli^se data were taken from the 1968 and 1969 
22-college data (Novick, Jackson, Thayer, and 
Cole,'' 1972) . Data from 10 colleges are stored on 
files C8LL6, C8LL7, C8LL8, C8LL9, C8LL10, C8LL11, 
C8LL12, C8LL13,, C8LL15, C8LL19 (1968 data), C9LL6, 
C9LL7, C9LL8, C9LL9, C9LL10, C9LL11, C9LL12, 
C9LL13, C9LL15, C9LL19 (1969 data). Each data 
set has five data elements: ACT scores (English, 
mathematics, social studies, natural science) and 

f irst-semeg^er college grade-point average (GPA). 

> 

(CM0D2G) Catalog Data-Set Loading 

'** < 
This moduie loads the catalogued data set 
specified by the user into the personal file. ^ 

(CM0D17) Data Transfer to Disk 



This module saves the data in the user^s personal 
file by transferring them to one of the files 
provided, on disk (DFILxx). The user must T>rovide 
the appropriate password ^d a data-set name 
which will be requested for identification at a 
later time. ^ , 
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Model 2 Data Display and Editing ^ ^ 

^This model allows the user to look at the data in 
the personal file. It also allows the usfer to 
modify individual values, to add data elements 
or observations, to delete data elements or 
observations, or to change the 'names of data 
elements. 

Module 1 (CM0D12) Data Display and Editing 

This module -allows the user to display and edit 
the data in the personal file, add observations 
or data elements, delete observations or data 
elements, and change data element names. In the 
display, observations are presented in blocks of 
ten. 
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Component 13 (CQMP13) Data Wans formations 



This program controls the activity of Component 13 • 

Model 1 Nullary, Unary, and Binary Operations 

This model allows the user to modify values of a 
, data set in a global sense* Most of the common 
operations and functions are available, such as 
addition, subtraction, multiplication, division, 
trigonometric fimctions (sine, coBine, tangent),, 
logarithm and exponential functions, and various 
special functions, (greatest integer, truncate, . 
logodds, root-arcsine). In addition, several 
logical operations are available, such as "less 
than", "not equal to", and "or". Conditional 
sequences- (IF- THEN-ELSE) are allowed, to a limited 
degree Uniform and, normal pseudo-random number 4 
generators are available. 

Module 1 (CM0D15). Control 

This module checks for the existence of a data 
set in the personal file and controls the flow 
of the model. 



Module 2 (CMODEO) 



Explanation 



This mcfdule provides a comprehensive explanation 
of the model. 

Module 3 (CMODEl) Operation Definition 

/ This module collects a set of operations and 

' allows the user to edit them. Table. 1 list's,- 

the set of available operations. The'*F,ILE' 
, data elements are those that are, or are to be, 
in the data set stored in the personal file. 
The *TEMP^ data elements are those that are 
V available for use during the transformation of 
a given observation. 
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TABLE 1 



NULLARY 

\ . IF 
2. JHEN 

4, BeViN 



11, X=UNIFC0»1) 

12. X^NORH(0»n 



**OPERATIONS«« 
UNARY 

101.. X-y'dT Y 

103. X=Y 

104. X'-Y 

105. *X=1/Y 

106. X=ABS(Y) 

107. X=SIGM.<7) 

108. X=INT(Y) 

109. X=SQR(Y) 

110. X=EXP(Y) 

111. X=LOG(Y) 

112. X=L0G10(Y) 

113. X=SIN(Y) 
J 14.' X=COS(Y) 

115. X=TAN(Y) 

116. X=ATN(Y) 

117. X=LOGODPS(Y) 

118. X=ASIN.SOR(Y) 

119. X=TRONC<Y) 





BINARY 
■ 


201. 


X=Y AND Z 


202. 


X«Y OR Z- 


203. 


X«Y EQ Z 


204. 


X»Y NE Z 


205. 


X=Y LT Z 


206. 


X-Y L5 Z 


207. 


X=Y 6T Z 


208. 


.X=Y Gfe Z 


210. 


X=Y+Z , 


211. 


X = Y-Z 


212. 


X=Y«Z 


213. 


X=Y/Z. 


214. 


X=Y"Z 


215. 


X=L06Y(Z) 


216. 


X=MAX(Y»Z) 


217. 


X=MIN(Y»Z) 







«#DATA ELEMENTS** 
FILE TDiP 




1. SEX 

2. VOCAB 

3. READN6 

4. ,!aRTHSK 

5. /COMPST 



-1 
-2 
-3 
-4 



UNUSED 
UNUSED 
UNUSED 
UNUSED 

5. UNUSED 

6. DBS * 
0. CONST. 



ENTER AN OPERATION CODE ( ENTER '0' TO TERMINATE ).? 
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Module 4 (CM0DE2) Operation Execution ^ 

This module executes the operations and replacef 
the old data set in the personal file'^th the 
new one. Data elements may be deleted i;or renamed. 



Model 2 



Sufficient Statistics 



This model calculates various summary statistics 
•from the data in the personal file. 

Module 1 (CM0D13) Summary Statistics 

Th±3 module provides summary statistics for 
the data in the user's personal file. It pro- 
vides means, standard deviations, extremes, per- 
centiles, midmeans, ranges, and correlation and 
covariance matrices. 



Model 3 



Matrix Operations 



Thijs "m^del allows the user to manipulate \ 
matrices. Up to ten matrices may be stored, the 
maximum dimensiohs of which are ten by ten. 
Almost any statistical analysis that can be- 
described as a series of matrix operations can 
be performed in this model. 



Module 1 (CMODBO) 



Matrix Explanation 



This module allows the user to obtain an explan- 
ation of the matrix package and to retrieve a 
matrix from the personal file. ' 

Module 2 (CMODBP) Matrix Menu and Matrix Operations 



This module offers the user a- menu of matrix 
management, standard matrix operations, or 
special matrix operations. The module performs » 
all matrix operations itself, and chains to 
CM0D6Q for n^trix management tasks. Standard 
matrix operations include matrix addition, sub- 
tra.ction, multiplication^ transposiltlon, calcula- 
tion of X*X, inversion, and calculation of the ' 
determinant, as well as scalar addition, subtrac- 
tion, multiplication^ and division. Special 
matrix operations include standardization, direct 
product, and sweep operation. 
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(QIODBQ) Matrix Management 

This module performs matrix management functions 
(input, output', renaming, reshaping, and editing 
matrices). 
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Component 14 (C0MP14) File Maintenance 

This program controls the activity of Component 14* 



Model 1 Directory Listings 

(Not yet Implemented) 

Model 2 File Reorganization 

(Not yet implemented) 



Model 3 File Sorting - 

This model allows the user to group the data in 
the personal file •into one to twelve groups* 
The grouping may be specified either by observa- 
tion n\jmbers or by the values of selected data 
elements. The groups may be chosen to be mutually 
exclusive or exhaustive. Any observations that 
. are not selected are deleted from the data set. 

Module 1 (CM0DI6) Data Grouping — set-up. module 

This module checks for data in the personal file. 
It also will ungroup the data if so desired. 

Module 2 (CM0D61) Data Grbuping --^ working module 

This module determines the method of grouping 
(observation numbers or data values) and'^sorts 
the ddta if necessary'. The ne\*, grouped, data set; 
replaces the old one in 'the personal file. 
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C(»1P0NENT- GROUP 2 Simple Bayesian Parametric Models 

Compooent 21 (CQMP21) Binary Models 

This program controls the activity of Component 21# 

Model 1 Beta-Binomial Model ^ 

This model confronts* the problem of estimat^ing 
the v/lue of a proportion tt. The prior distribu- 
tion ^s .assumed to be a beta distribution. The 
beta prior distribution along with the sample 
data forms a posterior distribution to be used in 
making inferences on the proportion tt. It is 
assumed that ir is from a binomial dlstr^ution. 
These modules make extensive use of subroutines 
* ^ BDTR {Calculating probabilities) and BHDR 

(calculating HDRs). 

Module 1 CCM0D2) Prior Distribution on Proportion %^ 

,This module helps the user to develop a natural 
conjugate prior distribution on a proportion that 
is a beta distribution. Both a fractile assess- 
ment procedure (FASP) and a weighting procedure 
are used (Novick and Jackson, 1974). Coherence 
checks are provided along with the ability to 
respecify at different points. Means, modes, 
variances, percentiles, and graphs are displayed 
to help in the process. 

Module 2 (CMODAB) Preposterior Distributions 

This module helps the user to carry out an 
adversary t>reposterior analysis on a proportion. 
A rough idea of different sample sizes effect on 
the expected means of the adversary posterior 
distribution is given. Also provided is a closer 
look* at the adversary distribution' once a rough 
sample size has been determined (Jackson, Novick, 
and DeKeyrel, 1978). 

Module 3 (CM0D3) Posterior Distribution 

This module combines sample data with 'the prior 
- distribution to form A posterior distribution. 
Means, modes^ standard deviations, percentiles. 
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and HDRs are provided for both the prior and the 
posterior distributions (Novjck and Jackson, 
1974). 

(CMODX) Predictive Distribution 

This module allows the user' to investigate the 
predictive distribution that is a beta-binomial 
distribution. For details see Component 91. 

(CMODB) Posterior Inten^ls 

This module allows the user to investigate the 
betaj)osterior distribution that was termed in 
MorfuTe 3. For details see Component 91. 

Beta-Pascal Model 

This model makes available standard methods for 
making inferences donceming a binomial propor- 
tion, assuming the data are available from a 
sequence of BemoulLi trials. The prd^r distri- 
bution is assumed to be the beta family and the 
sampling is Pascal. The beta distribution is 
evaluated using the subroutines BDTR (calculation 
of probability) and BHDR. See Applied Statistical 
Decision Theory , (Raiffa and Schlaifer,' 1961) for 
details. 

(CMODAA) Prior Distribution on Proportion^ 

This module assists a user to fit a beta distri- 
bution to his or her beliefs about a proportion. 
^ fractile assessment procedure and weighting 
procedure are used to help assess his or her 
beliefs .^(Novick and Jackson, 1974]). This module 
'^uses subroutines BDTR (calculating percentages) 
and BHDR (calculating highest density regions). 

(CMODAC) . Posterior Distribution 

This module ^combines the prior distribution with 
*the sample data to form the posterior distribu- 
tion that is a beta. Mean, mode, standard 
deviation, parameters, selected percentiles, and 
HDRs of the posterior and prior are displayed. 
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Module 3 



Hodule 4 



Model 3 



Modtile 1 



(■CMODY) Predictive Distribution (Beta-Pascal) 

This module allows the investigator to examine 
"the predictive distribution, which is a beta- 
Pascal distribution, (See Component 91 for 
details,) 

(CMODB) Posterior Intervals (Beta) 

This module allows the investigator to examine 
, further the posterior distribution, which is a 
^eta distribution, (See Component 91 for 

details,) 

Comparison of Two Proportions 

This model allows the investigator to examine 
the probability that the difference between two 
proportions is greater than some user-specified 
constant, 

(CMODT) Independent Beta-Distributed Proportions 

This module allows the user to enter up to five 
values of the constant for which the probability 
that the difference is greater, is calculated. 
This module makes use of the subroutine BDTR and 
the approximation given in Novick and Jackson, 
1974, section 10-5. 
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Component 22 



(COMP22) Univariate Normal Models 

This program controls *the activity of Co&ponent 22. 



Model 1 Two-Parameter Normal (Natural Conjugate Priors) 

. This model., confronts the problem of estimating 
the two parameters of a normal distribution, which 
are the mean (ji) and standard deviation (a) . 
Prior distributions on p and s0 are quantified. 
^ • Two different types of preposteriofcanaly^es may 
be performed, one being an adversary preposterior, 
and the other a consensus preposterior. Sample 
data are combined with the prior distributions 
and posterior distributions on y and o aire formed 
and may be investigated. This model is discussed 
in chapter,?, Novick and Jackson, 1974. 

"ilodule 1 CCM0D4) Prior Distribution on Standard Deviation 

^ r 

This module h^lps the user to quantify prior 
information on the standard deviation (a) from 
a normal distriboitiqp. Both a fractile assess- 
ment procedure CFASP) and weighted procedure are 
^ provided.' Coherence checks and the ability to ' 

^ respecify portTlons of the analy^sis are given. 
'The prior distribution on a is an inverse chi 
distribution (Novick and Jackson, 1974). Means, 
modes, standard deviations, percentiles, and HDRs 
are provided u^lng CSQDTR (probabilities) and 
ICHDR (HDRs). 

. Module (CM0D5) Prior Distribution on Mean 



This module helps the investigator to quantify 
thg conditional prior distribution on the mean 
(y) given the valued The "S^alue for a is 
either passed from Module 1 or entered by th 
'user. Both a fractile assessment procedure 
(FASP) and a weighted pt^ocedure are provided. 
Coherence- checks and the ability to respecify 
portions of the analysis are given. The condi- 
tional prior on y is a normal distribution 
(Novick and Jackson, 1974). Mean, standard 
deviations, percentiles and HDRs of this distri-- 
but ion are provided using the subroutine NDTR. q 
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(CMOD64) Adversary Preposterior 



This module permits the investigator to obtain a 
prior estimate of vhat an adversary's posterior 
beliefs would be following a sample of prespecif ied 
size (Jackson, Novick, and DeKeyrel, 1977) • 

(CMOD22) Consensus Preposterior 

This module can be used before an experiment is 
performed to predict an adversary's reaction to 
the data that the experiment will yield. The 
shortest consensus interval, which is an estimate 
of the interval <;49ntaining the population mean on 
which the decision makers could agree (Woodworth, 
1976)', is computed, 

(CM0D6) Posterior Distributions on Mu and Sigma 

This module asks the user to enter the sample 
data: sample "slze,^mean, and standard deviation* 
The sample data ar^^ftien combined with the priors 
on y and a to forni poffteri6r distributions* The 
posterior distribution on a. is an inverse Chi 
distribution with degrees of freedom v and scale 
^parameter X^* The posterior distribution on y 
,is a Student's t distribution with degrees of - 
freedom v , mean 5 > and scale parameter <• 

' (CMODC) Posterior Intervals for Mu ^ 

This module allows the user to examine the 
posterior distribution on the, mean (y) . This 
distribution ^s a Student's t with degrees of 
freedom v , mean 5 , and scale parameter k. The 
user may examine the following: 

1. Percentiles ' ^ 

2. Hi*ghest density regions 

3. Probability less than (greater than) 
some value 

4. Probability between two values 

-5. Graph ^ >^ 



" This module allot^sthe user to examine the 



(CMODD) 



Posterior Intervals for Sigma 
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posterior distribution on the standard deviation 
(a). This distribution, is dh'inverse ,chi gith 
degrees of freedom v and scale parameter X^. The 
user may examine the following: 

1. Percentiles ' 
. 2. -Highest density regions 

3. Probability less than (greater than) 
some value 

4. Probability between two values 

5. Graph 

Comparison of- Two Normal Means 

This model provides for the comparison of means 
from two univariate normal populations. It is 
assumed in this model that the variances are , 
unknown and unequal. The two posterior Student's 
t distributions are assumed to be independent. 
A Behrens-Fisher comparison is made, (Novick and 
Jackson, 1974, section 8-2). The two posterior 
distributions may be obtained by performing two 
runs of Model 1 — Two-Parameter Normal Model of 
Component 22. 

(CM0D7) Explanation of Two Independent t Distri- 
butions 

This module explains the posterior Behrens-Fisher 
distributipn on the difference of two normal 
means . 

(CMODF) Evaluation of Behrens-Fisher 

This modiile allows the user to examine a Behrens- 
Fisher, distribution with the same options as in 
Component 91. The user may view percentiles, 
HDRs, protlabilities less than some value^i prob- 
abilities* in an interval and graphs of this 
Behrens-Fisher . , 

C9p)arison of Two Standard deviations 

This model provides the comparison of two stan- 
dard deviations from univariate normal populations, 
assuming that each has a posterior inverse chi 
distribution. % ^ ' 
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Module 1 (CMODU) Independent Inverse Chi-Dlsti:;tbuted 
Standard Deviation ^ 

This ittodule allows the Investigator to exajnitie 
the ratio of the Uto standard deviations. The 
probability that this ratio is less than some 
specified value is calculated by considering 
• the F distriWrtion of the ratio of the posterior 
distribution of the variances (Novick and Jackson, 
1974* section 8-2) • 
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Component 23 (COMP23) Mult icategory Models 

This progi:aii} controls the activity of Coipponent 23. 
. Model 1 ^ Multinomial Model (Dirichlet Prior) 

* m 

This model makes available the standard natural- 
conjugate analysis ,for the multinomial mode!^ with 

• a Dirichlet prior distribution. ]?oth prior and 
^ posterior distributions are Dirichlet distribu- 

' tions, where the parameters indicate the proportion 
of the population falling into each category. 

" This analysis is described in chapter 10,, section 
7 of Novick and Jackson, 1974. * 

Module 1 (CMODG) Prior Distribution 



. This module* allows the user to assess a joint 

' prior Dirichlet distribution. The tact that the 
marginal distribjjtion on the proportion in any 
one category is a. beta distribution is used to 
help the user check coherence. The sum of the 
parameters <5f the marginal beta distribution for 
any category, must equal the sum of th^ parameters 
of the joint Dirichlet distribution. 'The user is 
first asked for point estimations of the propor- 

\ tion in each category under the constraint that 

^ the estimates must, sum to 1.0. These estimates 
are taken to be measures of ^the central tendency 
of the user's prior margipal distributions on 
the proportion in tli?V^^ective categories. The 
user is then asked for the 25th and 75th percen- 

. tiles of his or hfer prior marginal distribution 
on the proportion in each category. In general, 

. the beta.distributions fitted to the user's, 
percentile specifications will not 'satisfy the 

r^coherency condition discussed above. It is 
6* therefore necessary to fit a set of beta distri- 
butions and a Dirichlet distribution that satisfy 
the coherency conditions. The 25th, 50th, and 
75th percentiles of the fitted beta marginal 'dis- 

. tributions are displayed along with the joint 
estimates an^ the Implied hypothetical sample size. 
The hypothetical sample size is* equal to the sum 
of the parameters of the beta marginal distribu- 
tion on the proportion in any category and, by * 
coherency, to the sum of the parameters of the 
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Dirlchlet joint distirlbution. The user .can then 
change tjie l>ypx>thet|.cal sample size and/or point ^ 
esitlsiatps until he pr she finds a satisfactory fit 
Once be or she has Micated that he or she is 
^^tisfi^f fbe pa|raj5^ter8, mean, and mode of the . 
Dirichlet prior distribution, and selected percen- 
tiles of the beta marginal distribution are dis- 
played. 

(CMODH), J'osterior Distribution 

This module combines sample data^ith the user's 
prior distribution, and forms the posterior dis- 
-W:ibution, which is a Dirichlet distribution. 
The parameters (A and B) , mean, mode, and selectee 
percentiles of the posterior are displayed. 
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(COMP24) Simple Linear Regression Analysis 

This program controls the activity of Component 24, 

Simple Linear Regression Model (Informative prior) 

This model makes available a Bayesian linear' 
regression analysis with one predictor (X) and 
one criterion (Y) variable. The user incorporates 
prior'^informaiTion with the sample .data to form 
posterior distributions on the regression para-* 
meters. These aay then be more fully examined. 
This procedure is- discussed in section 9r-l of 
Novick and Jackson- (1974). 

(CMOD65) Prioi^^, Distribution 

This module* helps the user to form prior distri- 
butions' on the, parameters: a, 6,^ and a. The 
first step is to fit a line to the best estimates 
of Y given X *for> different values of X. This . 
model assumes tbat the *uncertainty about a ^ 
randomly saiiq)led Y given X has two components. 
First, there is uncertainty as to what the 
expectation of Y ^iven X is, and, second, there 
is the uncertainty (the residual uncertainty) 
that j^/otB.d-be thete even if the expectation of 
Y given X were known. 

The 50th percentiles of the prior distributions 
on Y given X and on the expectation of Y given X 
ate assumed to be equal. However, the 75th per- 
centile of the prior distribution on Y. given X is 
assumed to be greatet than the 75th of - the prior 
' distributicm on ,the expectation of Y given X, 
since the uncertainty ^bout Y includes the un- 
certainty about the expfttation of Y. 

The prior on t;he residual standard deviation (a) 
is an inverse chi, distribution, and the prior on 
the slope (3) and intercept (a) are t distribu- 
tions. 

• (CMOD66) Posterior 'distributions on Residual 
Standard Deviation and Slope ^ \ 

Thi^ module asks «the user to enter the sample 
*data: sample^ size (n)^ mean of pred^^^tor (X.), 
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variance of X, mean of criterion (Y.), variance 
Y, and correlation of X and Y. These are combined 
with the priors t<^ form posteriors on the residual 
standard devlatioiv^( Inverse chi) and the slope 
(Student's ,t). 




Module 3 (CMODS?). Evaluation of Posterior Distributions 



This nodule allows the user to ex^ne the pos- 
terior distributions on Y and the taean of Y. The 
user may look at percentiles-, highest density 
regions, and probabilities less than specified 
values for X. 

Module 4 (CM0DC9) Save the parameters of the regression 
equation 

This module permits tlie user to save the para- 
" meters of the regression equation in the personal 
file to be used by Component Group 3 for decision 
analysis. 
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Component 25 



CCOMP25) Multiple Linear Regression Analysis 



This program controls the activity of Component 25, 

Model 1 Nonlnformatlve Priors 

This model provides a standard Bayeslan analysis 
for simple or multiple regression model assuming 
nonlnformatlve prloi: distributions • The analyses 
are discussed in Bayeslan Inference in Statlsticai 
analysis (Box fltnd Tiao, 1973). 

Module 1 (CM0DC5) Selection of the independent and depen- 
dent variables to form the regression model. 

This module displays the variables in the sample 
data an4 requests the user to select the indepen- 
dent and dependent variables for the regression 
^ model. 

Module 2 (CM0DC6) Computation and display of the pos- 
terior distribution of the regression equation 

This module * computes the mean and the variance- 
covariance matrix for the posterior distribution 
of the regression coefficients and the degrees of 
freedom for the distr.iiution of the variance ,of 
error. 

Module 3 (CM0DC7)f Examination of the posterior distribu- ^ 
tion of the regression equation 

This module allows the user to have the options 
for examijjing tlie posterior distribution of the 
regression equation. The options are: 



1* The distribution of th^e variance of error 

2. The posterior analysis^ of the regression 
coefficients 

3. - Observed and predicted criterion values 

for the sample data 

4. Predictive distribution for chosen 
predictor values 

5. Save the parameters of regression 
equation in personal- file 



(CMQDC8) Display of oi^erved and predfteted - 
crltifttion yalues for the sample data ^ 

This loodule pennltl the user to display^ observed 
V4aue»» pt%dieted vidiiea^'^ttd reslduais. of the 
criterion variable for the sample data, 

(GMCN)C9) Save-^the parameters of the regression 
equation 

This nodule permit* the user to save the parameters 
of the regression equation on personal file to be 
used by Component jSroxxp 3 for decision analysis* 

Inf^tmativt Priors 

This model provides a standard Bayesian analysis 
for simple or multiple regression model assuming 
not«l conjugate priors* The modeL provides a 
proi^dure for the assessment of a Bayes distribu- 
tion for the regression coefficients* The para- 
Mters to be estimate vlll be divided into three 

1. A vector indicating the central tendency 
of the distribution for regression model* 

2* Two nximbers, the degrees of freedom and 
the scale factor for the distribution 
of the variarice of error (residual 
vari«mce); jointly these two parameters 
determine the^ center and the spread of 
the dj^stribution* ^ 

3. A matrix measuring the dispersion ofjthe 
-distribution for the regression coeffi- 
cients^*^ • " 

This procedure is described in "Interactive 
Elicitation of Opinion for a. Normal Linear Model" 
(Kadane, DicWey, Winkler, Smith* and Peters, 
L978)* 

(CMCffiCl) Explaxtation and entry of the dependent 
and indepehdent variables 

This module provides the user with a brief descrip- 
tion of the assessment procedure and requests the 
name of the dependent aijid independent variables, 
and the largest and the smallest values of the 
independent variables* . * 
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Module 2 



Module 3 



(CM0DC2) Estimation of the parameters of the 
central tendency and the degrees of' freedom 
» 

This module asks the user to specify the 50th, 
75th, and 90th predicted percentiles for various 
values of the independent variables. The module 
then estlmat€»sr the central tendency parameters 
for the regression coefficients ai^d the degrees 
of freedom parameter for the variance of error.. 
An opportunity Jo change the specified percentiles 
is provid^^ . • • / 4^ 

CCM0DC3) Hypothetical data met^W to estimate 
the parameters of the scale factor and the disper- 
sion matrix. 




This module asks the user to provide the 50th, 
and 75th predicted percentiles conditioned pn 
some hypothetical data. The modixle then estimates 
the scale? factor parame^ef for the variance of 
error "and the dispersion ihatrix parameter for the 
regression coefficients. 

CCM0DC4) 'Display of the parameters of the Bayes 
distribution for the regression coefficients and 
the variarfce of error. ' - \ 

Jhis module displays the parameters of the multi- 
variate' t. distribution for the regression coeffi- 
cients a^d tfie parameters of the Inverse Chi- 
sqi^ar^ distribution for the variance of error. ^ 

Module 5 CCM0DC5) Selection of the independent and depen- 
dent variables and entry of prior information. 

This module requests the us^r to select the 
independent and dependent vanables and allows the 
user to enter prior information from the terminal 
if it^ts n6t stored on^the personal file. 

Module 6 CCM0DC6) Computation and display of\he po^erior 
distribution of the regression equation 

This module computes the mean and the variance- 
covari^nce matrix for the posterior distribution 
of the regression coefficients and the degrees of 
freedom for the distribution of the variance of 
error. 
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Module 7 CCM(M)C7) Extoinatiott of the posterior distribu- 
tion of the regression equation 

• Thitf nr)dule allowar &iB user the following options 
^ for exattlttlng the posterior distribution of the 

regression ^ equatioti: n 

!♦ The distribution of the variance of error 
2* the posterior analysis of the regression 
coefflci^ts 

3. Observed and predicted criterion values 
for the saB^le data < 

4. Predictive distribution for chosen 
predictor valxie«[ 

5* Save the parainetere of regression 
equation in personal file 

Module 8 tCMM)C8> Display of observed and predicted 
criterion values for the sample data 

IMs laodule permits the* user to displayvpbserved 
values^ predicted 'values* and residuals of the 
criterion variable for the 8aa?>le data. 



Module 9 



CCrtM)C9) 
ec^uatlon 



Save the parameters of the regression 



This ttodule permits the tiser to save the paran^eters 
of the regression eqiiation in the personal file 
to be used by Component Group 3 for decision 
analysis* 
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COMPONENT GROUP 3 Decision Theoretic Models 

> 



Component 31 



Itodel 1 



(COMPSl) Utilities and Expected Utilities 

This program controls the activity of Component 31 ♦ 

Assessment of Utilities 

This mpdel is conqemed with fixed-state methods 
of assessing a subject's lAility function, in 
which the subject is required to. state proba- 
bilities that equate certain gambles* Three 
different assessment procedures are provided in 
this model to help the user checking the coherence: 

1» Fixed-state least-squares assessment 
. 2* Regionalrcoherence assessment 
^ 3» Local-coherence assessment 

Module 1 (CMODQ) » Explanation of Utility Theory and Entry , 
of Outcomes — Least-Squares Assessment 

W ' ' ' • 

This module asks the user to specify the nine 
outcomes for which he o,]c she wishes to assess the 
utility function ♦ These do not have to be equally 
spaced* ^ Also provided is an optional explanation 
that presents the user with some of -the philosophy 
TiehCnd the utility theory* 

ModtLLe 2 (CMODJ) Entry of Probabilities and Calculation of , 
Initial Utilities — Least-Squares Assessment 

• * ^ 

This modulp asks the user to enter the indifference 
probabilities for adjacent gambles. The module 
then askg the user to specify* indifference proba- ^ 
bilities for additional gambles, forming a set of 
gambles that will be used to cfheck coherence. 

Module 3 (CMODK) Least-Squares Fit of Utilities 

' This module provides the User with a list of the 
gambles and indifference probabilities previously 
specified. An opportunity -to change the proba- 
^ bilities is provided. After all changes have been 
m made and the least-squares fit computed, the 

gambles are again listed, along with the specified 
probabilities', fitted probabilities, and log-odds 
' differences between the two. 
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V Module 4*. (CHODBA) Explahation and Entry of Outcomes — 

\ , Reglottal-Coher6nce AssesSihfent 

This TBodule bf f6tS fttt o^libttal explanation to 
tht USfer tWd thd mtty of tM outcomes 

Ofiv6, &eVen, or ftittfei fbt the tfegional-coherence 
assessment; 

Module 5 (<a!0fl67) tlfeglbttiil^'Cdhgtfefte^ A§Se^»lneht 

The reglottdl ass^sSfi^nt ^toe^dute involves the' 
ccnstttittibft oi hy^dthetttiai ch'di(Si^ituations - 
using a for-sUre* option and a chance option. A 
for-stire option is, a& th^ name implies, an option 
that bf £e« th^ d^ciSloA todket tht certainty of 
kftdiHLftg the outcome of a certain decision. A 
chants bptron^ on th6 other hand, is one that 
IttVelveS imfefttfeaittty about the outcbme that will 
t^mlt £tm dhoodixlg- it* th^ chAtlce options used 
itt thl* a§&fessMnt ^totedut^ involve the possibil- 
ity df twb different oultdSnesk The three outcomes, 
ftoA tKe fot-su1r6» Aftd tub ffbto the chance 
^ bf>tldft| teiSt §ttod itt A i>atticulAr relationship 

ti> tAch bthfet itt otd^t fbtr thfe choi<:e situation 
tb he iSieaningful. 'Th6 two possible outcomes of 
\ . , .the cihattce option must b6 such that the f or-sure 

optibtt out^on^ id intettnfediate in preference to 
^the*» An iterative ptocedure on different situa- 
''tions'^is ei^uted to test coher^ce of the user. 

. Module 6 CCWODBB) EJcplMation of Lbcal Coherence and 
Entry of Outcbftes ^ 

This tiibdul^ allbXrs theoUSet tb view an optional 
> explanatibri the local-^boherence assessment 

ptbc^durfei the u&6t si>6^ifi«s five, seven, o?; 
ttitie outbomeS for which A utility fuiiction is 
desired. 

Hodjtae 1 CCMOflBS) itesessiwent Procedure for Local Coherence 

the local-cohefence utility assessisent 'procedure 
^ can be tiS6d with five, seven » ot nittfe different • 
oiitcomes. In each cAse the smallest^' -and largest 
V ^ 6utc<anes are arbitrarily assigned utility- 0 and 

1, resp6ctiS/Sply« there are u - 2 <u » 5, 

7» or 9) dutcdtoes to which utilities must be 
• assigned. This is" .then done by using u - 2 
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different triples of outcomes, selected so that 
the indifferences probabilities determined for 
the different triples are sufficient to uniquelv- 
asBign the u - 2 utilities • There is no provision 
to check- for incoherences by constructing addi- ' 
tional hypothetical choice situations* The 
utilities consistent with the user*s preferences 
are calculated and displayed^ 



Model 2 



Evaluation of Utilities 



This -model is concerned with the analysis of the 
utilities • The utilities can be obtained by one 
of the assessment procedures > from model 1 or the 
user can enter the utilities directly. The model 
provides the following option for evaluating 
utilities: 



1, Display the assessed^ utilities and those 
implied by any fitted parametric function 

2, Display the indifference probabilities 
for choice" situations that are implied 

, by the assessed titilities and any fitted- 
parametric functions y ^ 

3, . Display a graph of the assessed utilities 

or, of any utilities determined by a 

fitted parametric function 
4* Fit the normal and Student^s. t CDF to 

assessed utilities 
5, Fit a generalized beta CDF to assessed 

utilities 
6,. Compute the expected utilities 



Module 1 * (CMODR) Control of the Evaluation of Utilities 

This module checks whether the lit'ilities are in 
* ^ the personal file and allows the user to'fenter 
the outcomes and utilities# 



Module 2 



(CMODAR) Examination of Assessed and Fitted 
Utilities 

This module controls the evaluation of the 
utilities and displays the utilities* Indifference 
probabilities' implied by assessed and fitted para- 
metric utilities for choice situation are computed^ 



FRIC 
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^ Module 3* (CMQDL) Fitting Normal and Student's t to Assessed 



Module 4 



Module 5 



This agdjile fits ^ tfesl 68? 9U<I § Student s t CDF 
-to 'the liter's lea8fc^i^J^a"re§ (LSQ) tttilities. The . 
fitting" grocgdurf §-ct\}§lly cgjjggrn^d ytth fitting 
the inSifference prgbabilities implied by the LSQ 
V utilities." The logrodds of the indifference prob- 
abi-lities Implied By the fitted nprm&l ogive and the 
i(S.Q 4iili^4.6§"^?^ 4i|f(^ei?e§^ •§'?4 tlvB 8«m of these 
differences misimized to determine the best fit. 
After "^a nornial'"GDF has been fitted to tlie LSQ utili- 
ties," a Student's t fit 'is ^ittempted using the same 
prope4ure. 

(G1K|D^) ?1-tting a Generalized Betf to Assessed 
Utilities 

Thi« lQ^.»le f it§ the entire generalized beta 'CDF to 
tlii iSQ uiilitip§. Tljree different fits are found 
using t>e fractile ^ssessise;>t procedure fFASP) . 
• Estimates of thp 2'5th. 5Qtn, and 75th percentiles 
f qund losing the l.£LQ y^llltie^ §nd linear inter- 
palatlon. Thi§ module §l%.q alloj^s the user to 
iWf^S^isatg" thg generalized beta with the following 



1. 



2. 



3. 



4. 
5. 



DispljBi^ the assessed and fitted beta 
utilities 

Display the iiidiff erence probabilities for 
gei§c?ed choice situ^tiqqs implied >y the 
ass§p^e4 and ^itte4 beta utilities 
pi^pl^y the indifference probabilities for 
choice situations implied by the assessed 
an4 fit?e4 beta u|ilities 

Graprthe assessed or fitted beta utilities- 
Select one of tl>f beta fits fqr theiitility 
functiofa 

(CMODA^) ExBicted Utility (Normal, kudent's t, and 
Beta nistril^iition^)^ 

This mqdulg ai^lq^s the u%er to compute expectation 
'^ith respect to" the fol-lowing distributions: 

1. Normal 

2. Student's t 

3. Generalized beta 



It- O 
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(COMP3r2) Educational and Employment Selection 
This program controls the activity of Component 32. 
Quota-Free Selection (One Group) 

In quota-f ree-^selection each accept /reject decision 
is made in4ependently for each applicant. A 
particular decision is not affected by previous 
decisions or by tho^e to be made in the future. 
Each applicant is considered independently of the 
other applicants. 

This model presents a quota-free selection .model with 
a threshold utility function. The threshold utility 
function implies that each applicant is considered 
to*be in one to two possible states, in this case 
either qualified or unqualified for the position or 
program. 'This threshold uti^lity function can be 
represented in the following schematic way. 



S 
T 
A 
T 
E 



Qualified 

• ♦ 

Unqualified 



DECISION 
Reject Accept 



Ideally, each decision^maker wo\ild like to have all 
decisions be correct, ^d indeed, if the decision 
maker knew at the time of each decision the status 
of the applicant, all decisions would be correct. In 
practice, however, the decision maker can-mot know, 
for sure the applicant's status* 'The bfest that can , 
be said is that the decision maker knows in a' 
probabilistic sense the applicant's status. 

If the. deci^on maker knows the probability p that 
the applicant is qualified, then according to the 
principle of maximizing expected utility,* the de- 
cision should be made- by computing the expected 
utility of both the accept and the reject decisions 
and taking that action that has -the greater expected 
utility. 
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(CMODBC) Assessment of Threshold Utilities 

This module c^^:^cula.t^a thre8l\pl<J utilities that are 
^ppiro^^Jtajt? when %h,e ovitcon^e of selection can be 
categoi?ize(i as either suceess or failure. The selec- 
%%Qn 4ficiaiQn ca^ X^d, to qn^ of t^^e following possi- 
bilities: 

1. Au applicant is afccepted and succeeds 

2. Atf applicaijt ia rejected wl\o woixld have 
sudceede4 had he or she been selected 

a. "An applic^t is^Tejjected who would have ^ 

failed )xad he or she been accepted 
4. An app^ica^t is accepted and* fails 

• (CM0D9Q) determination of Predictor Cut Scores 

This module provides selection solutions for both 
aipgi^ multiple predictors with a single criterion. 
A 'particuiar criteripn value is~ specified by the 
decision maker to mark the minimum criterion indica- 
tive ot success. ^The prediction equations^are then 
used to determine the probability that- an applicant 
will be successful.' This is taken to be the proba- 
bility tli^t the applicant:* iQ qvialified. 

Fox the ajLftgle* predictor case7 given the utility^ 
function/ the prediction equation, and the minimum , 
svQce^s,8.ful criterion score ^ the minimum. predictor 
scQre required for selection is foujad. The predic- 
tion eqtia.tions m^iy >e entered in this module or they 
could previously have been placed in the personal 
.file by the regression models in Component Group 2. 

Restricted Selection (Two Groups) 

i 

!fhis model presents, an assessment prdceduire for 
Peterseh*s model for restricted selection (Novick^and 
Petersen, X976.; Petersen, 1976; and, Petersen and Novick 
197f) from two groups witl\ different threshold utility 
functions. Th^ first step in the analysis is to 
assess individual threshold utility functions for 
both groups* This uses the same procedure as in the 
quota-^free selection ca&e. See Component 32; Model 1, 
Module 1* The utility functipns for the two groups 
are represented below: 
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GROUP 1 



GROUP 2 



reject 


accept 




rej ect 


accept 


h 




qualified 




^2 






unqualified 


^1 


°2 / 



Utilities are assessed independently for each group 
and scaled so that the utility of the most-pnref erre'd 
'outcome in each group is 1.00^ and the least-preferred 
outcome in each group t3 .00, 

The next step in the procedure is to assess information 
from the investigator so that statements may be made 
involving applicants from both groups at the same time. 
After assessment, the next step is to determine cut- 
off scores for both groups such that the selection 
procedure maximizes the expected utility of the 
selection, process under the constraint that only a 
specified percentage of the total applicant pool can 
be accepted. The user may then view the selection of 
the applicants from the applicant pool. In the 
selection of the ^applicants, the analysis will be 
performed on a maximum of 150 observations from each 
group . 

Module 1 (CM0D91) Assessing Utilities Preparation 

This module provides the user with a short explana- 
tion and requests the names of the two groups for which 
a decision must be made. ' . ^ 

JJodule 2 ^ (CM)DBI) Assessment of Utilities for Two Groups 

This module involves the assessment of. utility 
.structures for each group independently^ The assess- 
ment procedure requires the user to consider an 
applicant from each group under thfe^^assumption that 
only one applicant can be accepted. The user is told 
the probability that each applicant will succeed if 
selected and then indicates which applicant he or she 
would select. The v^ssessment procedures determine 
- pairs of probabilities for which the user indicates 
no preference between 'the two applicants. .Thesd so- 
called indifference probabilities 'are sufficient to 

^ 55 . 



58 



detcnaitte a pair of utility structures that reflect 
the u«er*» preferences • 

HodUle 3 (CMOOBE) Scaling the Two Utility Functions 

* 

This module scales the two utilities of each group so 
that the most-pref etred outcome in both groups' has 
- utility 1 and the least-preferred outcome h|te utility 

Module 4 (CMODBL) Control of the Determination of Cut Scores 
and the Selection of Applicants 

This module determines whether the data set, utilities 
and prediction equations are in- the personal file. 
It allows the user to enter the utilities from the 
temlna^l* ' 



Module 5 



Module 6 



XCMODBK) Enter the Regression Equation for Each 
Group — Single Predictor 

This module provides the options for entering the 
regression, equations for the determination of ^cut 
scares. The user can enter the 'regression equations 
or. sufficient statistics from thm terminal if the 
regression equations 'have not been stored in the 
personal file« 



(CM(©9Y) Determinati( 
Single Predictor 



of Cut Scores for Each Group — 



This module has the user enter the distribution of 
predictors within each group, and the percentage of 
the apt>licant pool that Is from each group and the 
minimum successful, score. In the determination of 
the. cutVjscores, the module displays the cut-off scores 
'and percentages of each group selected for iton-user- 
specified percentages of the total applicant pool to 
be accepted^ The user can- then specify percentages 
, and the cut-score and group percentage will be 
displayed. ^ 

Module 7 (CM0D9R) Selection of Applicants 

This module reads the predictor information and 
utilities frcan the personal file and calculates and 
^ displays which applicants would be selected from the 
applicant pool* 
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Component 33 (00^33) Educational^ and Employment Assignment 

' This program controls the activity of Component 33. 

* #^ 

Model 1 Assignment with threshold Utilities 

This model assumes that each person assigned to a 
treatment will, upon completion 'of the treatment,, be 
judged to have succeeded or failed on the basis of the 
performance *on ah outcome measure. For each treatment 
there is a particular value of the criterion variable, 
^ called the cut score, that marks the dividing line 
between success, and^ failure. It, is assumed that the 
same predictors are used to predict the outcome in 
each of the treatments, even though the outcome 
measures for the treatments may be different. It is > 
also assumed that the ^optimal assignment for a person 
is the treatment that yields the highest expected 
utility. In* this model there may be either two or " 
three treatments. In assigning the applicants to the 
treatments, the^ analysis will be perfontied on a 
maximum of 200 observations. 



Module 1 (CM0D9P) ~ Assessment of Utility Structure 

This mqdule begins by asking the decision maker to 
\ consider choice^ situations that involve assigning a 

person to either treatment 1 or treatment 2. The 
choice situations present the decision maker with the 
probabilities that the person will succeed if assigned 
to ^treatment 1 and ask the decision m^ker to specify 
the probability of success for treatment 2 that would 
indicate indifference between the two assignments. 
This procedure can be lexp^nded to three treatments, 
in which case the procedure is repeated for treat- 
ments *1 W 3. Nine sets of probabilities *are then* ^ 
lis^^ed to be examined. 'If satisfactory, the utility 

structure is fchen -presented. , , 

«> * 

' . • \ 

Module 2 (CMODBD) Control of fche Determination of Cut Scores 

and the Treatment Assignment 

This module detsermines if the data set, utilities and 
' predicticin equations are in the personal file. It 
allows the users to enter the utiltie3 from the 
, . \ terminal. 

Module 3 (CMODBF) Two Treatment Assignment 

This module performs assignment to one of two treatments 
under the following assumptions. The expected utility 
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of any assignment is assumed to be equal to the sum 
of the^expected utilities of the individual assign- 
ments. For -any person, prediction equations and 
threshold utilities #r^ used for each treatment to 
calculate the expected utility of assignment to each 
of the treatments • Tfhe optimal assignment is assumed 
to be the one that iWKlmizes the sum of the individual 
exp^^ed utilities. When there are no constraints on 
the number of persons that can, be assigned to each ' 
treatment, the optljial assignment is to assign each' 
person to the treatment with the greatest expected 
utility. 

« 

(CM0D9Q) Three Treatment Assigninent 

This module performs assignment to one of three treat- 
ments cruder the following assumptions. In the three 
treatment case where there are constraints on the 
ntmiber of persons that can be assigned to any one 
treatmeint, we have so far only consjLdered the case 
where a specific number of persons are to be assigned 
to each treatment. The expected ^itility of any 
assignment is assiimed' to be equal to t^ie simi of the 
expected utilities of the individual assignments. For 
any person, the prediction equations and threshold 
utilities are used to calculate the expected utility 
of assignment to 6ach of the treatments. The optimal 
assignment is assumed to be' the one that maximizes the 
sum of the individual expected utilities. 

(CMODCA) Determination of cut scores for each treat- 
ment — Single Predictor 

This module determines the cut scores for each* treat- 
ment. TH^ user is required to provide the minimum 
successful criterion score. ,The regression equation 
may be' entered from the terminal. 

Assignment with Conditional Utilities 

Thl9 model is concerned with assigning candidates to 
one of two "treatments", which may be educational or 
vocational training programs. The outcome of a treat- 
ment is assumed to be shown by the score on a posttest. 
This score is estimated using a regression equation 
based on previous experience with the vtreatment^. 

The utility of a particular posttest score ts 
conditional; it depends on how the score compares with 
expectations, based on the candidate's score on a 
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pretreatment test. If two persons obtain the same 
posttest score, there will be more utility in prov:*''- 
ing the treatment to the person who had the lower pre- 
test score. , 

The user specifies three pretest scores representing 
low^, middle, and high levels of performance. At each 
pretest level, four posttest scores afe entered to* 
define' minimal, satisfactory,' good, and superb per- 
formance. All posttest scores described by a given 
label have the same utility. Therefore, it suffices 
to assess utilities only at the middle level on the 
pretest. For this level the user provides three 
additional posttest scopes, which lie between those 
for adjacent labels. Then utilities are assessed at 
these seven points. 

The procedure to define utilities at other pretest . 
scores is illustrated in Figure 2 'which is a contour 
diagram., of constant utilities. The posttest scores 
x-,'w..,x- correspond to minimal,..., superb performance 
at level M (i.e., middle) on the pretest. Scores y^, 
^3^5*^7 \^ (i.e., high) are also specified by the 
user, cori^esponding. to minimal,..., superb levels of 
performance'. Remaining values are defined by 
(y^-^yi^)/(y3-yp = (x^-xpV (x^-x^^) , etc.. Then straight 
lines are drawn to join corresponding points. At any 
pretest level W, values z,,..*,z- corresponding to 
Xj^,.J.,x^ are defined by these lines. The utility of 
a score at W i^fe the same as that of x^ at M. 
Utilities are assumed to increase linearly i>etween 
successive scores, e.g., between z^ and z«. All 
scores below at W have utill^ty 0, and those above 
Zj have utility Ic Thus the utility function is 
defined at all values of pretesjt and posttest scores. 

Each candidate has a pretest scorfe. Therefore, utility 
is known as a ^function of posttest score. For each 
treatment, its regression equation is used to calcu-^ 
late the predictive distribution of posttest score. 
Then the program calculates expected utility over 
this distribution. In the absence of limits on enroll- 
ment, the candidate should be assigned to tlie treatment 
which yields higher expected utility for him/her. 
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Module 1 KCmU) Entry of Pretest and Posttest Scores 

i^iii 18 ttife first st^ in ABSessing conditional 
utilities, ks explained in the overview, the ufeer 
enters three fJretest scores* four posttest scores tor 
each of these, an^ three additional scores at the 
tniddie ievel m the pretest. At each stage* the user 

' has the typtioh to change any or all the posttest- 

scotes entered up to that point. 

Module 2 (CM0ttB9) ' Choice of Assessment Procedures 

This modnie asks t^ie user to 'choose between regional . 
and local coherence procedures to assess utilities.. 
The |)ri»cedu'res will be explained if desired. 

Module 3 (dmDm Wility Assessm^t Using Regional Coherence 

Regional coherence is tised to assess utilities of 
polttest scores.' For details see Coinponent 31, Model 
1, Module. 2. 

Module 4 (CM0DB8) Utility Assessment Using Local Coherence 

Lacal coherence is used to assess utilities of P° at- 
test scores. For details see Component 31, Model i, 
IslO^le 3. 
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(CM0DB6) Collect Information Needed for Assignment 

This. is the first step in assigning candidates to 
treatments. The program first checks for availability 
of data in the personal , file. If ^ the data set Contains 
groups; the user is asked to select one for assignment.^ 

Next, the program looks for (at least two) regression 
equations in the personal fi-le. If these are avail- - 
able, the pser is asked which equation should be used 
with^which treatment- If equations are unavailable, 
the user may exit to the regression* component , enter 
equations from the terminal, or have CADA enter equa- 
tions based on Data jSet 5 in the Catalog. 

Finally, scores and utilities are needed. If these are 
not in. the persi^nal file, the user may enter them 
from the terminal using CM0DB5 (Module 6) or- assess 
them using Modules 1 to 4. When all information is 
available, the program chains, to CMODBJ (Module 7), 

(C>K)DB5) Entry, of Previously Assessed ^'Scores and 
Utilities 

This module is used if utilities have been assessed 
but are no longer in the personal file. Pretest and 
posttest scores are entered as in CM0DB4 (Module 1), 
then utilities are typed in. ^ 

\ 

(CMODBJ) Expefcted Utilities and Assignment to Treat- 
ment 

» 

Expected utilities of both treatment's are 'calculated 
for each candidate using the model described in the 
overview. Averages for the treatments are printed. 
A listing of all persob«^s optional. For each 
person, this shows all sc^TJSfi, both expected utilities, 
and recommended assignment. The user may specify 
limits on the numbers of persons that cait be assigned 
to treatments.. 
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.COMPONENT GROUP 4 Bayesian Simultaneous Estimation 




exponent 41 (CCMP41) Simultaneous Estimation of Proportions 

This program controls the activity of Component 41- 

Model 1 Arcsine Transformations 

This model i^rovides guidance in estimating simultaneous 
proportions from exchangeable groups. An arcsine 
transformation is applied to the proportions as in 
section 10-1 of Novick and Jackson, 1974. Techniques 
for the case of equal sample sizes fox each proportion 
are abased on "Marginal Distributions for the Estima- 
tion of Proportions in m-Groups'^ (Lewis, Wang, and 
Novick, 1975). Also included in this model are 
techniques for analyzing unequal sample sizes. These 
* have been discussed in "The Estimation of Proportions 
in m-Groups", (Novick, Jackson, and Lewis, 1973).^ 

Module 1 (CM0D8) Prior Distribution 

This module helps the user to assess a prior distri-Vf 
but ion on an exchangeable proportion ir. The prior 
distribution for this model is a beta, and the proce- 
dureA used to assess it are the same as in Component 
21, Model 1, Module 1. Both a fractile assessment 
- procedure and a weighting procedure have been used to 
' help in determining coherence. These are discussed 
in section 6-5, 6-6, and 6-7 of Novick and Jackson^ 
1974* 

Module 2 (CMODA) Po^erior Distributions (Equal Group Sizes) 

This module obtains posterior distributions for the 
probabilities of success (tt) in m different exchange- 
able groups for the case in which sample sizes for all 
groups are the same* A variance-stabilizing transforma 
tion (arcsine), is employed, but all results are given 
in terms of irvalues* Joinr and marginal point esti- 
mates of irfor each group are displayed along with 
^ selected percentiles. 

Module 3 (CM0D9) Posterior Distributions (Unequal Group Sizes) 

This module obtains posterior distributions for the 
probabilities of success Ctr) in m different exchange- 
able groups for the case" in which sample sizes are not 
equal. An arcsine transformation is used; however, all 
results are displayed in their metric. Posterior jpint 
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'modal estimates of ufor e^^ch group, based on the jointf 
mode of the transformed tt values, are displayed, . # 
Marginal estimates of tt for each group also may bd- 
obtained t 
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*• 


Component 42* 

•i 


(C0MP42) Simultaneous Estimation of Means ^ 
This program c^^^^H^^ activity Jor Component 42. 




* 

r 

• 


Model 1 


Equal Within-Group Variances 

This model assmes that the user has exchangeable 
beliefs about the group means. The within-group ^ ■ 
variances are assumed equal. The theory and method 
are based on Lindley. and Smith (1972) . - 




\ 


Module 1 


(CM0D76) Prior Distribution 

' This module assists the user in fitting distributions 
to beliefs about: 

1. the grand mean; 

2 the nfean from a randomly selected group; 
3! a randomly selected- observation from a group 
with knovm mean. 

By fittipg distrubtions.to beliefs about these values, 
it Is possible to infer prior distributfons on: t 




> 


- 


1. between-group standard deviation; 

2. within-grq,up 'standard deviation . 




• 


Module 2 


'(CM0D77).. - -Posterior" Cistributions r 

This module .oUains posterior distributions for the ^ 
means of m (maximum 12) dif f erent ^groups under the 
TslZ^n that^'.the prior beliefs about the means are 
exchangeable. .The user is asked to «nter: 








1. Tiumber of groups; ..' ' . „^„„^flrri 

2. number of ob^rvations', mean, and standard 
' " • deviation for each group. 




• 

• 


• • I 


The sampler data are then combined with, the prior « 
I^str^utJons to form posterior marginal distributions 
of the group means and linear combinations of group 
means'. ' : ' 








r 
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Component 43 (C0MP43) Simultaneous Prediction in H-Groups 

• This program controls the activity for Component 43; 

Model 1 ^ Equal Slopes 

* .This model makes available a method for simultaneously 
estimating regression in m~groups. The slopes are 
assumed to be identical in the m-groups, but the inter- 
cepts may vary.' This method is a specialization of the 
Bayesian linear model developed by Lindley and Smith 
(1972). The techniques used in this model i/ere 
developed by Shig^su (1976) ancL extended in "A Note 
on Bayesian Simultaneous Linear Regression with 
Constant Slopes" (Lewis, 1978). This model assumes », 
exchangeability among the groups studied with a ^ 
maximum of 10 groups. The analysis will "be performed 
upon a maximum of 25 observations from each group. Up 
to three predictors and one criterion variable ar^ 
allowed. 

Module 1 (CMOD94). Entry of Data 

This module checks the user's personal file for data 
of the appropriate form. If there dre iione, the user^ 
must use the CADA Data Management' Facility (CDMF) to 
, enter or retrieve data. The Sample Regression Data 
5irt, consisting of 10 groups, 4 variables, and 25 
observations, may be used. It i^described Under 
Component Group 1, Cojnponent .12, mod^ivl,* module 3.\ 

Module 2 (CM0D62) " Least-Squares Setup * * ^ . ^ 

This module displays the groups and varicilbles in 'the 
user^s personal file, asks for. criterion ^variaMes/r^'^^ 
and -predictor variables. .It then performs prelimin^ify 
least-squares^ calculations. ' * * - 

Module 3 (CM0D9C) Bayesian and Least-Squares Estimates 

This module displays Bayesian -and least-squares 
estimates for the ijiteccepts, slopes, and residual / 
standard deviation. There is one intercept for each 
group arid only one set 'of regression, coefficients, 
since they are assumed equal. 

■ A'' ' 

(CM0D63) Prediction - • \. 

This module allows the user to obtain point estimat^ • 
and probability assessments f^r each group for future 
oT)servations given any set' of entered values for the . 
predictors. 



Module 4 
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COMPONENT GROUP 5 Bayesian FtiH Rank ANOVA 



Coaponent 51 (C0MP51) Model 1 Factorial Analysis of Variance 



This program controls the activity of Component 51. 
The component provides Bayesian analysis of variance 
based oh a non-informative prior distribution of cell 
means and residual (within-cell) variance. The^ 
Bayesian ftill rank approach introduced by Novick et. 
ai», in, CADA-WTS is adapted, and expanded. A design 
with 1 to 4 factors and 2 to 32^ cells can be analyzed. 
Main effect and interaction parameters are computed 
as linear combinations of cell means. The posterior 
multivariate t distribution of these parameters may be 
studied* In particular posterior means and standard 
deviations of these parameters are available as well * 
as credibilities. (The credibility of a hypothetical 
parameter point is the probability content of the 
smallest highest density region (HDR)' containing that 
point. This*method of analysis is based on ideas 
presented in Bayesian Inference in Statistical Analy- 
sis (Box & Tiao, 1973).) 



Model 1 Place a 'Breakdown' file of . sumokary statistics on the 

personal file. 

Module 1 (CMODDl) Assembly of Summary Statistics 



This module controls the activity of the model, 
user has these options: ' 



The 



1. Display summary data already on personal 
file. - 

24 Compute, display and file summary data from 

raw data on personal file. Not^: Raw data 

is destroyed. . 
3. Type in summary data at' the terminal, 

and file it*. Note: 

destroyed. 



display 
Any data on file is 



Module 2 CCM0DD2)^ Entry of Summary Statistics from the Terminal 



Model 2 



This module is, controlled by CMQDDli, It provides 
option '3 of Modef L..^ \ ^ ^ 

Compute Main^ effects and Interactions , 



This model allows the tiser to select linear combina- 
tions of cell means (main effects and interactions) . 
For each factor the user 'may select the default 
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definition of main effects (successive differences) or 
may type in contrast coefficients. Interactions are 
automatically generated as 'products' of main effects,. 
It is also possible to select 'simple' main effects 
although this option is offered only when the user is 
returning to Model 2^ from Model 3. Simple main effects 
are ^plained in Chapter 5 of Statistical Principles x>f 
Experimental Design (B. J. Winer, 1971). 

Module 1 (CM0DD3) Generation ^of Main Effects and Interactions 

This module asks the user for 'main effect' linear 
combinations of levels of each factor (default or 
-"^^^-^ — user-supplied), generates from these the 'interaction' 
linear combinations, computes the parameters of the 
posterior distribution of main effects and interactions, 
and files these parameters. 

.(CM0DD4) Tutorial on Main Effects and Interactions 



Module 2 



This module is controlled by CM0DD3. It provides 
tutorials -on main effects and interactions. 

Module 4 (CMODDM) Storage of Parameters 

This is an 'invisible' utility module used to append 
the posterior , parameters to the summary data file. 



Model 3 



Analyze Posterior Distributions 



This model allows the user to study the posterior 
multivariate t distribution of the parameters. The 
user is guided through a series of steps. 

Step 1 : Posterior njeans and S.D.'s of parameter are 
^ displayed^' 

Step 2 ; User is 'allowed to condition on or marginalize 

any parameters. 
Step 3 : User is offered these options: 



a) 
b) 



c) 



Redisplay the (now conditionalized) posterior 
means and S.D. ' s. 

Compute the probability content of the 
smallest HDR containing user— specif ied values 
of the active parameters (neither conditioned 
nor mairginalized) . 
End this 'round' of analysis.. 

i) Add more conditions or marginaliz^tions. 
.ii) Return to Model 2 to redefine main 

effects and interactions, 
iii) End Model 3. 
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nodule 1 tCMODDl) Analysis .of Posterior t-distributions -of 

. • . • ■ U ' 

Thl« aBoflul* .conttroHs ttihe actit^Hity Model 3. 

•Hodtile a .Cal'culatioi. -of TifbabiQaity Content o^f 

Smallest HDR 

'Th±« i-odule .controll^ 'CMOBDS. It ^omputes and 
' . ISjilSa Se j«obebmty cogent ,of a Mgl^est density 
* ""^region (HDR)- , • 
Module 3 (CM0DD7) Tutorial on mghe^ Density Regions 

■ Thi.B module is oontroli^d hy CM0DD5.. It provides a 
tutorial on HDR's. 
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Component 52 (COMP52) Analysis of Repeated-Measures Designs > 

This program controls the activity of Component 52. 
The component is a duplicate of Component 61. It 
provides analysis of repeated-measures designs and 
analysis of covariance. Informative priors may be 
used. It can also perform the analyses provided by 
Component 51 for model 1 designs with 27 cells or 
fewer; (But note that Component 52 cannot process a 
summary data set generated by Component "51 — the 
user will have to reload the raw data.) The capacity 
of this component is: 

M + B£28 

(W-l) X (B+l)<120 

where 

M = # of measures per- subject 
and 

-B # of cells "between" subjects. 

There can be up to 4 "within" subject factoifs and up 
to 7 factors in all "between-" and "within-" subjects 
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CCTiPONENT GROUP 6 Bayesian Multivariate Analysis 



Component 61 (C0MP61) Bayesian Full-Rank Multivariate Analysis ' 
of Variance " 

This prograi^ cont:|:ols ,the activity of. Component 61* 

Tht9 compon^t pirQvi4§s B^yesiaa multivariate 
analysis of variance of designs involving up to 
seven factors, of which no more than four can be 
'Vithin subjects".. 

♦ 

The user may select? a non-informative prior (Box 
and Tiao, 1973, p, 426) or may type in the para- 
meters of an infom^tive, conjugate matric T 
prior* The user may transform the cell means - 
into main effects and interactions, as in Compo- 
nent 51, ox keep the cell mean parametrization. ^ 
The user may then examine the posterior, matric • 
, T distribution of the par^eters. This method' of 
analysis ±b based on ideas presented in Chapter 8 
of. Box and Tiao, 1973, For i^orB-^det^tLls run 
Model 7 (Tutorial) of this component. 

Summary data cojaputed by this component are 
available to the data management component for 
transfer to a permanent file (if the user has a. 
password). These data can be reloaded for re- 
analysis in a later session* After reloading the 
analysis can begin where it left off. 

This component can perform the following analyses: 
Factorial ANOVA and MANOVA, Repeated-Measures ^ " 
ANOVA and MANOVA, Growth Models, Analysis of 
Covariance and some Multivariate Analysis Of 
Covariance. Its limitations are: 

1. No more than 5 dependent variables plus 
within subjects factors combined 

2. No morfe thai^S factors plus dependent 
variables combined 

3. No more than 28 cells "between subjects" 
plus measurements per sublect combined 

4. No more than 120 cells in all 
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Model 1 Put Description of Layout of Experiment on File 

1 

This model determines the layout of the data; 
i.e., the name, niimbeir of levels and type Cbetween 
or within subjects') of each factor and the names 
of the dependent variables. This information is 
placed .on the personal file in a group named 
"FACTOR". The functions of th^ model are carried 
out by the following modules: ^ 

Module 1 (CMODfiSO) Determine Layout of Design to be Analyzed 

This module controls the activity of Model 1. 
The options it of f ers ^i'epend upon what type of 
data it finds on the personal file: 



1. With raw data the user is shown the 
variable names and group names . (if any) 
and asked to specify the role of each 
variable in. the analysis: between- 
subjects factor, within-subjects factor, 
dependent variable or not • in the analysis . 
This module then reads the data and 
determines the number of levels of each 
factor. . 

2. With summary data CADA reads layout 
information from the personal file, shows 
it to the user and asks if these data 
are to be analy:^d. 

3. If there are no data on file, or the 
filed data are not to be analyzed, the 
user is invited to type in all the layout 
^information. 

Module 2 (CMODDF) Continuation of CMODDO 

This module collects layout infonnation from the 
user (option 2), 

Model 2 Put Prior Information on File 

This modal allows the user to enter the parameters 
of a prior distribution and places them on file. 
The user has these options: 

1. Non-informative prior 

2. Informative - conjugate prior 

The activities of this model are carried out by 
these modules. 
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Module 1 (CMODDA) Collect 2*Z Matrix from the Terminal 

This is: a Utility module which is used here to 
collect parametets of the prior distribution from 
the user imder bption 2# 

Module 2 \CMODDM) Add Group to Personal File 

Thig is -a -utility module used here to place the 
ptibt parameters dh the personal' file in a group 
named "PRIOR". 

Model 3 Put Summary Statistics on File 

This Inodel collects or computes summary statistics 
and puts them on the personal file. There are two 
options: 

1. Compute summary statistics from raw 
eata. (Note: These raw data must have 
been on the personal file before this 
component was etitered) . 

2. Type in sutetoary statistics at the ter- 
minal. The summary statistics are: cell 
n's and means and pooled, wi thin-cell 
standard deviations and correlations. 

After execution of Model 3, the design information 
and simnnary statistics are on the user's piersonal 
data file and may be transferred to a permanent 
file any time before exiting from^-CADA. The 
following modules perform the activities of this 
model : 

Module 1 (CMODDA) Collect Z'Z Matrix from the Terminal 

This is a utility module which is used here to 
collect summary statistics from the terminal 
under option 2.' 

Hbdule 2 (CMODDE) Compute Summary Statistics from itaw 
Data on File 

Itodule 3 (CMODDM) Add Group "to Personal File 

This is a utility module used here to place 
summary statistics on the personal file in a 
group named "Z'Z"*. 
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Model 4 



Compute Posterior Distribution of Cell Means 



This model computes the parameters of the 
posterior matric T distribution of the cell^ means. 



Module 1 (CMODDB) ^ix Prior and Posterior Distributions 

This module computes the parameters of the pos- 
terior i^tric T distribution of the cell means 
using tre parameters of the prior distribution 
and the summary statistics on file, (Note: For 
the non- in formative prior no computation takes 
place since the parameters of the posterior matric 
T are the summary statistics) . , ' ^ 

/ Modifle 2 (CMODEM) Add Group to Personal File 

^ This is a utility module used here to place the 

^posterior parameters on the personal file, in a- 
group named /*POST**. 



Model 5 



Transform Cell Means to Effects and Interactions 



This model transforms the posterior distribution' 
of the cell means to that of the main effects, 
and interactions. The user is shown the name 6f 
each factor and asked to say how its main effects 
are to be defined. The options for each factor 
are: 

1. Standard' effects - i.e.,. effect //I = 
level 2 - level 1, effect Jf2 = levfetO - 
level 2, etc. 

2. Normed orthogonal polynomials 

3. Uselr-supplied contrast coefficients 
or ^ 

4. Don^t define effects - break down the 
analysis according to levels of this 
factor 

Thia model constructs t\^ interaction contrast 
coefficients as products of main effect coeffi- 
cients, and transforms the parameters of the 
posterior distribution as in formula (8.4.44) of 
Box and Tiao, 1973. For more details see 
Woodwoxth, 1979 and .the tutorials in Model 7. 
The activities of this model are carried out by 
these modulesv 
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Module 1 (CMODDG) Select Definitions of Effects* , Build 
Transformation Matrix 
» » 

This module collects effect ^options from the user 
and constructs "between" and "within" transforma- 
tion matrices. (P and Q of Sox and Tiao, 1973 



formula 8.4.44) 



(P a^c 



Module 2 (CMODDG) Continuation of CMODDC: Calculate 
Transformed Parameter Matrices 

This module calculates the parameters of the 
matric T distribution of the effects and inter- 
actions. 

Module 3 (CMODDM) Add Group to Personal File 

This is A utility module used here to place the 
parameters of the transformed distribution on^^ 
the personal file in a group called "T*name T" 
where name refers to the last set of parameters 
^ on the data file, 4.e. , name = PRIOR if an 

informative prior has-been entered but the summary 
data have, not, name « Z*2 if a non-informative 
prior was used and name « POST if an informative 
prior- has been combined^ with the stmamary data. 

Model 6 ' Examine Matrix? T Distribution of Parameters 

This model allows the user to examine a matrix T 
distribution (prior or posterior) of cell means 
or effects and interactions. The distribution 
may be conditionalized or marginalized. The 
distribution analyzed is the last one the user 
/ ' has placed on the data file. The following 
modules carry out the function of this model: 

Module 1 (CMODDD) Examine Matric T Distribution 

^ This module controls the activity of this model, 

offering options; 

1. Display means and standard deviations of 
MANOVA parameters. (Note; The standard 
deviation here is the "standard deviation 
of the matric T distribution of the . 
MANOVA parameters (ceU^ means or effects 
and interactions) - it is analogous to 
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the^ STANDARD ERROR of an estimate in c 
classical statistics.) 
2* Alter the status of MANOVA parameters 

i) remove a^l conditions/marginalizations 



• (i.e., reload parameters from file) 
ii) add conditions or marginalizations 
3. Compute the credibility of a hjrpothetical 
set of parameter values 'typed in by the 
user. That is, compute the probability 
content of the smallestf highest density 
region (HDR) containing the hypothetical 
parameter values • (Note: With a non- 
informative prior this probability is 
generally equal to 1 minus the signifi- 
cance level attained by Wilk's lambda 
test of the 'Vpothesis" that the MANOVA 
parameters .equal the hjrpothetical values 
tjrped in by the user, although there are 
minor differences, in the-^egrees of 
freedom^ for error for classical and 
Bayesian analyses under some patterns of 
conditioning.) • 

(CMODDH) Conditionalize and/or Marginalize 

This module displays the names of the MANOVA . 
parameters and asks the iliser* whether to keep, 
conditionalize or marginalize each parameter — 
certain mathematical "restrictions on the pattern 
of conditioning and tnarginalization are enforced. 
See the tutorials in Model 7 or Woodworth, 1979, 
for more details. 

(CMODDI) Sweep Operator 

This is a dual-^purpose jnodule which either collects 
the user's conditional parameter values ahd 
computes parameters* of the conditional matric T * 
distribution (option 2.ii) of the remaining para- 
meters or collects the user's h3rpothetical 
parameter values, 6uyp> Copt ion 3) and ebmputes 
U(6uYp) (Box and Tiao, 1973 Formula 8.4.49 or 
Woodworth, 1979,^ pp. 390-391). - 

(.CMODDJ) Calculate Content of HDR , . 

This module computes th^probability content of 




the smallest HDR containing 6 



'HYP- 



It uses Rao's* 
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F-api>roxtmati©n to the di«tribiAion of U<.ejjyp) 
CWoodnortti, l$79^ yuge 391). 

Model 7 TtftorUl 

This model .provl^«« tutorials on aawdysis of 
multivariate eaqpertoeat^ designs. It offers 
iasfcn«^lon onz 

I. Factors mA ^wclables 

2« Bav <ftta £ormat<r 

3. Nummary ^s^c;9tistU:s 

4, Main f^^ots and toteractions 
5* »re«flcdi5«i*p on a factor 

6^ Matrlc T distribution — conditioning 

' and iioargilaalislQ^ 
7* SDR*s 

Mbdul4B 1 KCMSPUK) MANOVA Tiutorlais 1^ 2 and 3 
Module 2 (jCMDDDL) MANOVA Tutorials 4 through 7 
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COMPONENT GROUP 7 Elementary Classical Statistics 

Component 71 (C0MP71) Frequency Distributions 

. 'This program 'controls the activity for Component 71* 

Model 1 ^ Absolute-Frequency Histograms'' 

) ♦ 

Ifodule 1 (CM0D43) Absolute- Frequency Histograms 

This module allows the user to obtain a histogram 
of any variable in the personal file. The user 
specifies the number of intervals (up to 15) and 
whether the user or the system is tD select the 
interval boundaries. 

Model 2 Contingency and Expectancy Tables 

Module 1 (CM0D14) Two-way Contingency and Expectancy Tables 

This' module allows the user to view overall con-^ 
tingency and expectancy tables, or independent 
expectancy tables on any two variables in the 
personal file* 
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Component 72 

Model 1 
Module 1 



(C(MP72) Summary Statistics 

This program controls the activity for Component 72 
Summary Statistics' 

IN 

(CM0D13) Summary Statistics 

This Tuodule allows the .user to obtain a variety 
of descriptive statistics (means, standard devia- 
tions, percentiles, etc.), a variance-covariance 
matrix, and a correlation matrix* 
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Component 73 

Model 1 * 
Module 1 



Model 2 
Module 1 



«;OMP73) Graphic Displays 

This program controls the activity for Comi/^ent 73. 

Absolute-Frequency Histograms * 

(CMOD43) Absolute-Frequency Histograms 

This module allows the user to obtain a histogram 
of any variable in the personal fiXe, specifying 
the number of intervals (up to 15) and whether 
the user or the system ±s to determine the 
interval boundaries. 

Bivariate Plots ' * 

(CMOD42) Bivariate plots 



This module allows the user to obta^in a bivariate 
scatter plot of any two variables in the personal 
file. 



Componeiit 74 (CdMP74) Regression 

• ' This program controls, the activity for Component 74 • 

Model 1 Sljople or Multiple^ Linear Regression 

Module 1 (CMODBl) Entry of Data , , 

, . - The module asks the user to provide the dependent 

aad independent variables and computes the jegres-- 
sion coefficients, standard errors, F,X, » 
residiials* ' 

Module 2 CCM0DB2) Regression Analysis 

The nodule controls the regression analysis. The 
• user can specify residuals and predicted values 
via. tables, normal probability plots of residuals, 
. or bivariate scatter plots • 

Module 3 (CMOD42) Bivariate Plots 

This module allows the user to obtain a bivariate 
scatter, plot for the variables in the regression 
equation or the r'esiduals (RESIDL) or predicted 
values CY-HAT) . 

(Ch^D9I) Normal Probability Plot 

This module allows the user to view^ normal 
probability plot of the rdsidual from a regression* 
This module is also useS in the EDA component ' ^ 
group. ^ . ' 

(CM0D15) Transformations 

This inodule allows the user to transform the 
values In the personal file/after a regression 
analysis, and before anotlier regression analysis . 
This module calls CMODEO, (M)DE1, and CM0DE2, 
which are described in Component Group 1. ^ 
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COMPONENT GROUP 8 Exploratory Data Analysis (EDA) 
Component 81 (C0MP81) Univariate EQA 

* 4 • 

This program controls the activity of Component 81. 
Model 1 Regular CRT Applications 

I 

This model presents univai^iate- techniques that may 
be displayed on standard i4-line by 80-character 
CRT terminals. There are two help module's that 
explain univariate EDA an^ describe techniques 
which can be used to answer questions that are 
often addressed in data analysis. Each technique 
also has an optional explanation that provides . 
instructions, examples, and uses , for the technique. 
This model has adapted techniques from Exploratory 
Data Analysis (Tukey, 1977), Data Analysis and 
Regression (Mosteller and Tukey, 1977), and 
Methods for Statistical Data Analysis of Multi- 
variate Observations (Onanadesikan, 1977). An 
in-depth explanation of this ^cdmponent appears in 
Conversational Exploratory Data Analysis (Isaacs, 

* 1978). The user has the following options: 

Overview 

1. Descriptions r of methods in Explor- 
atory Data Atialysis (EDA) 
* 2. ^.^estions involved ia ED^^nd 
associated techniques 
Techniques I 

3. Bo*^«iftt^ 

4. Stem- and- Leaf Diagram 

5. Empirical Probability Density - 
Function (EPDF) ^ 

I 6. Smoothed EPDF 

7. Empirical Cumulative Distribution 
Function 7 

8. ^ Normal Probability Plot 

, . Alteration ^ ; 

9 . Standardization 

10; Transformation (Reexpression) - 
11. Trimming of Extremes 
1^. Selection of a new variable ^ 
13v Retrieval of original data (after 
alteration) . " 
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Module 1 (CM0DA3) Explanation of Univariate EDA 

This module gives the user a short general expla- 
nation of univariate EDA. The user is also 
• introduced to those aspects of data vhich. are^ 
usually addressed by EDA» Upon Qompletion of 
this module, control is passed to Module 2, which 
describes in detail the information available 
through EDA» 

e 

Module 2 (CM0DA4) Questions in Univariate EDA ■ 



This module lists questions that need to be 
answered to explore univariate data. Each 
question may be addressed in detail, if the user 
wishes. The question is explained and the tech- 
niques that best answer it are shown.- A summary 
table that ranks the techniques best suited to 
answer each question concerning the aspects of 
the data is also provided. The following ques- 
■ tions are addressed: 

- 1. What are the extreme values of the data? 

2. What is the central tendency? 

3. -flow variable are the observations? 

4. How many modes do the data have? 

5. Are the data symmetric or skewed? 

6. Are the data flat br peaked? 

7. Are there' outliers? 

8. Are there gaps? 

9. Are the data normally distributed? 

10. Can abnormal appearances be reduced by 
transformation? 

11. What happens after standardization? 

12. What is the result when the outliers 
are St rimmed? 

' 13. Is there a felling or floor effect? 

Module 3' (CM0D9D) Selection of Variable 

^ This module allo^/s the user to choose for examina- 
tion one of the variables in the personal file. 
If the summary statistics option is Requested in 
' this module, it leads the user to Module 15. 

Module 4 (CM0l)9E) Option List 

This mpdule provides a list of available options. 
/ The list" is divided into three sections: 
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overview, techniques, and alteration. The 
options are listed in the overview of this 
model* 



Module 5 (CMOD99V Box Plots 




This module first prefeents t(ie user with an 
optional explanation of box plots as they have 
been implemented. This explanation presents 
sample box plots that are explained in depth 
regarding potential uses. Those characteristics 
of imivariate data that may be seen from box 
plots are also listed. The box plot of the " 
variable specified by the user gives a visual ' 
impression of the extremes, range, quart iles, 
mean, median, and standard deviation. 



Module 6 (CMOD98) Stem-and-Leaf 

This "module first presents the user with an 
optional explanation of stem-and-leaf s as they 
have baen implemented. Included in the explana- 
tion are sample stem-and-leaf- plots, their us^s, 
' *and thV aspects of the data they display. A stem 

% may appear on one, two, or £ive lines, depending 
on the data. All leaves are single digit, which 
allows the user to get a picture of the data. 
This provides the user wiith two significant 
digits of accuracy and a visual xlisplay of the 
obseryat^-ons. 

Module 7 (CM0D9H) Empirical Probability Density Function 

This module first presents an optional explanation 
• of the empirical probability density function ^ 
(EPDF) , with examples, uses, and particulars of 
this technique' as implemented. This technique 
divides the vertical axis into 20 intervals and 
plots ithe number of observations in each interval, 
as* in a histogram. 

> 

Module 8 (CM0I)9J) - 'Smoothed Empirical Probability Density 
Function 

"^This module presents an optional explanation of 
a smoothed EPDF as implemented. This technique 
allows the user to smooth the EPDF any number of ^ 
times to obtain a curve that does not show 
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idiosyncrasies, method of running means is 

used for the sirfoothing. 



Module 9 J CM0D9A) En?)irical Cunajlative Distribution Function 



This module presets an optional explanation of 
the empirical cumulative distribution function, 
(ECD7). Examples, uses, and techniques are 
displayed' and described. The horizontal axis 
apd vertical axis are both divided into 60 inter- 
vals. An ECDF is a plot of the I-tK ordered 
observation on the vertical axis versus (I - .5)/N 
on the horizontal axis. A maximum of 60 observa- 
tions may be plotted, so an algorithm is used -to 
select observations. Three different symbols 
(. * ^) are ii^d to plot observations. In this 
way the vertical axis is divided i^to 60 intervals 
while using only 20 lines. The . appears lower 
than the *, which appears lower than the *. 

Module 10 CCM0D9I) Normal Probability Plot 

^ * ' • This module presents an optional explanation 

containing uses, examples, and techniques of this 
implementation of normal pr6bability plots. In ^ 
a iiormai probability plot,* quant iles of the uni- 
variate data on the vertical axis -are plotted 
against quantiles of a standard normal distribu- 
tion on the horizontal axis. The vertical axis 
is divided into 20 intervals, ranging from the 
lowest to the highest value. The -horizontal axis 
is divided into 60 intervals from -3.0 to 3.0. 
If the plot is an approximately straight line, 
; then the d^ta 9roba|)ly came from a norpial distri- 
bution*. 

Module 11 (CM0D9K) ' Standardization 

This module allows the user to standardize the 
univariate data -into values with a mean of zero 
and a standard deviation of one. These data 'can^ 
then be. examined by any of the univariate EDA 
techniques. This module provides only temporary 
♦ alteration of the data. If the u^er Wishes a . 
permanent change of the personal file, this module 
'is not appropriate. For permanent changes use 
Component 13, Model 1. 
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Module 12 /CMOD90) Transformation (reexpression) 

'This module allows the user to transform the 
variable that is being examined. The following 
transformations may be used: 

1. Power or linear ^ 

2. Logarithm to user-sfecif ied base 

3. LogHDdds, with base of logarithm given 
by user 
Arcsine 

. Log-odds (base* 10) transformation of rank 

Explanation and appropriate uses of each transfor- 

on may be obtained. Once transformation 
has naken place, the data may not be transformed 
again without retrieval of the original variable 
or selection of -another variable. This module 
provides only temporary alteration of the data. 
If the user wisTies a permanent change of the per- 
sonal file, this module is mot appropriate. For 
permanent changes^ use Component J.3, Model 1, 

Module 13 (CM0D9W) Trimming of Exti?emes 

This module^ allows* the user to trim extreme yalues 
from either or both ends of the univariate data. 
Up to 15 percent may be trimmed off from each end. 
^This module provides only temporary alteration of 
the data. If the user wishes 'a permanent change 
^f the personal file, this jnodule is not appro- 
priate. For peBraanent changes use Component 12, 
Model 2. ' • 

Module 14 (CM9D9N) Retrieval of Original Data (after 
^ -Alteration) 

This module allows the user to obtain unaltered 
data that were being examined before standardiza- 
tion, transformation, or trimming took place, t 

Module 15 (CM0D13) Summary Statistics ^ 

This module provides the user summary statistics 
for all variables in the personal' file. This 
module' works independently of tlie modules fox 
temporary alterations. That is^^ thid module 
always reports the summary statistics of the orig- , 
^ inal data. See the explanation of Component 72. 
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Component 82 CC0MP82) Bivariate EDA 

This program controls th^ activity of Component 82. 

Model 1 Regular CRT Applications 

As in univariate EDA, the major goal of bivariate 
exploratory data analysis is to give the invest 
tigator an intuitive impression of data. In 
bivariate EDA, the investigator is interested in 
the aspects of two variables. Prevalent trends, 
tendencies, and an overall picture of the data 
provide a description of the two variables for 
the investigator. Bivariate EDA also gives the 
* investigator an insight into particulars of the 
data. These particulars consist of outliers, ^ 
gaps, secondary modes, and other irregularities. 
' This mixture of general and particular details 
' provides the investigator with a description of 
the data being examined. Bivariate data are 
•examined from three different points of viey: 
independently, jointly, or condition^ly. Thus, 
the user can use thes^ to form a more complete 
description of the data. .Bivariate EDA is de- 
scribed in greater detail in Conversational 
Exploratory Data Analysis (Isaacs, 1978). The 
user has the following options:^ 

*• 

Overview 

1. Overview of blvariate-exploratory 

data analysis (EDA) 

2. Questions in bivariate EDA and 
associated techniques 

Techniques 

3. Summary statistics ^ 
A. . Scatter plot 

5. S'chematic plot 

6. Univariate EDA conditional on X 

7. Conditional expectation (regression) 
plot 

Alteration 

' 8. Standardization 

9.- Transformation (reexpression) 
10. Triraning 
^ 11. Selection of new variables 

12. Retrieval of original data (after 
alteration) y 

^. ■ . * 
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Module -i 



(CM0DA5) 
Analysis 



Overview of Bivariate Exploratory Data 



The bivariate overview module presents the inves- 
tigator with several frames of text that provide 
direction and guidance in the use pf bivariate 
EDA. The first two fraines present an explanation 
of the major goal of bivariate EDA: 'to help the 
investigator achieve an intuitive impression of 
data. * These frames also present some of the 
philosophical underpinnings of the development of 
bivariate EDA. A list of the aspects of data to 
be considered is presented. These aspects are: 
extremes and magnitude, central tendency, vari- 
ability, modality, skewness, kurtosis, normality, 
outliers or gaps, and relationship between the 
-two variables. These aspects can be considered 
independently, jointly, and conditionally to give 
the investigator a full description of the data. 
Module 1 automatically leads into Module 2. 

Module 2 (CM0DA6) Questions Involved in Bivariate EDA and 
Associated Techniques 

This module provid^s the investigator with a list 
of questions that are mc^t likely to be addressed 
in 'the exploration of bivariate EDA. These are 
provided in the order in which the questions 
would typically be addressed. A list of these 
questions follows: 



1. What are the extreme values of th^ data? 

2. ''What is the central tendency? 

3. .How variable are the observations? 

4. How many' modes do the data have? 

5. Are the data S3nnmetric or skewed? 

6. Are the data flat or peaked? 

7. Are there outliers?, 

8. Is there a ceiling or floor effect? 

9. Are the data normally distributed? 

10. How strong>^s the relationship between 
the two ~vaM.ables? 

11. Is the relationship a smooth trend or 
are there distinct, separate clusters? 

12. Is the relationship linear? 

13. Does^ the magnitude of the variability of 
o one variable x:hange across the range of 

the other (h^teroscedasticityf ? 
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A summary of the questions and techniques that 
best address .them is then presented^ This summary 
indicates whether :a technique addresses the data 
independently, jointly * or conditionally. This 
summary table provides a large amoupt of infoma- 
tion^in one frame. An investigator inay plan 
necessary analyses from this summary. 



Module 3 C.CM0D9V) Selectidaa of Variables 

This module allows the user to select the two 
variables of current interest from those in the 
personal file. If; stmmiary statistics option is 



requested^ the program proceeds to Module 24. 



•'^ Module A CQIODAl) Option List 



This module presents the user with the option list 
from xdiich the user can select the desired tech- 
nique. The options available are listed in the 
overview of this model. 



Module 5 (CM0DA9) Summary Statistics 

The summary statistics module pf bivariate EDA 
provides an investigator with statistics for both 
variables.^ They help the user to gain insights 
into each variable independently. The following 
statistics are provided: high, low, mean, 25jji 
percentile (Ql)^ 50th percentile (Q2 or median)/) 
75th percentile (Q3), standard deviation, variance, 
and interquartile range CQ3 - Ql) . These statistics 
help the investigator to examine the following 
aspects of each variable by itself: extremes, 
central tendtocy, variability, ^nd skewness. This 
option also provides the user with a short explana- 
tion of the statistics and how they should be 
interpreted: for example, skewness can be judged 
by comparing the difference from the 25t^h percen- 
tile to the median against the difference from 
the median to- the 75 -percentile. 

• Variance/Covariance Matrix and Correlation Matrix 
are also provided. . ' , 

Module 6 (piODAZ) Explanation of Scatter Plot 

This module ' provides an explanation pf a scatt,er 
plot, example, and uses. ^ It then rej:ums the , 

I • • • v. . «^ 
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user to M9dule 7, where the actual scatter plot 
of the data is produced. ' ' 

Module 7 CCM0DA7) Scatter Plot 

A scatter plot of bivariate data provides the 
investigator with a joint plot of the two variables. 
The ranges of the variables on both X and Y axes 
kxe divided into 2Q intervals to form 400 cells. 
The number of observations that fall into each 
cell is shown on the grid. Special symbols are 
provided if 10 or more observations fall in a 
cell. The following shows the S3rmbol plotted for 
a 'given number of observations ^in a cell: 



Number of ' Observations Symbol Plotted 

0 , blank 

1 through 9 ^ digit 

. ^ • . 10 through 19 & 

20 through 29 . * 

30 or greater ^ $ 

A SQatter plot shows the investigator a two- 
dimensional picture of data. A third dimension 
can be seen by the number of observations in a 
cell. The higher the nximber of observations, the 
greater the density at those values of the X and 
Y variables. Flat areas and peaks can be seen 
from the values of the ^hird dimension. 

Module 8 CCM0DA8) Ejqplanation of Schematic Plot' 

This module provides an explanation of a schematic 
plot with examples and uses. It then leads the 
\ . user to Module 9, where the actual schematic plot 

' ' " of the data is 'produced. h ^ ^ 

Module 9 CCMODAI) * Schematic pfbt 

This technique provides the investigator with a 
sensitive tool for studying the trend of the Y~ 
variable as the X-varialile increases. The display 
consists, effect, of side-by-side conditional 
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box plots* The X-variable is divided into four . 
inter-^uartile intervals or 'slices* containing- 
^ ~ approximately equal numbers of observations. Jor. • 

each X-slice> the |)0X plot of the Y- values 'in ' 
»^ thQ slice is shown* Besides four conditional box 

" .plots of t;he Y-variable, the box plot of the X- 
variable is provided also. The box plot of the 
X-vaffiable is rescaled ^o that it has the same 
range as* the Y*-variable. The scale foir the Y-^c *^ 
plots is provided at the left margin. The loc^j^ 
tions of the Y-box plots are* not meaningful. "They 
are equally spaced. Conditional summary statistics 
are also provided. 

Modtde 10 (CMODAK) , Definition of Conditional 

This ^I^iDdule allows the user -'to define a conditional 
on the X-variable. The data on the Y variable, 
are then saved in the. personal file. Control is 
then passed to Modifle 11. 



Module 11 (CMODAS) * Conditional Selection 

■Jliia module allows the' tiser to select any of the 
univariate techniques to examine the conditional 
data. A list of *the univariate techniques follows: 



1. / Box#plot 

2. Stem-and-leaf 

3. Empirical probability density function 
(EPDF) 

4. ^Smoothed EPDF 

5. Empirical cumulative distribution function 
(ECDF) 

6. Nornal probability plot 



Module 12 tCM0D99) Box Plot 



^^dule 13 



This module allows the user to view a box plot of 
the Conditional of Y on the range of X defined 
in Module 10; For an explanation see Component 
81, Model 1, Module 5. - / 

(CM0D98) ^ Stem-and-Leaf ^ 

This ioo.dule allows the user to view a stem--and- 
leaf of the conditional of Y on the range of X 
defined i'h. Module 10. For an explanation ^ee 
Component 81 < Model 1, Module 6. 
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Module 14 ' (CftOD9H) Empirical Probability Density FunctiSn 

This module allows the user to view an EPDF of 
the conditional of Y on the Ange of X defined 
in Module 10. For an explanation* see. Component 
. 81, Model 1, Module 7. ^ ^ ./ 

Module 15 (CM0D9J) Smootlhed EPDF 

This module allows the user to view a smoothed 
♦ EPDF of the conditional of Y on the r^nge of X 
defined in Module 10. For an explanation see 
Component 81, Mocjel 1, Module 8. 



Module 16 *Tc80D9A) ' Empirical Cumulative "Distribution 
Function (ECDF) 

This modul^enables the user to view an ECDF of 
the conditional of Y on- the range of X defined 
in Module 10. For an explanatiqp .see Component 
81, Model i,' Module 9. " - ' 

Module 17 (CM0D9I)^ Normal Probability Plot 

' ' ' 

This module permits the^user to view a normartr' 
probability plot of the condif ional of Y on the 
r^ge of X defined in Module 10. For an explana- 
tioh see Component"* 81, Model i, Module 10. . ' 

Module 18 (CMODAP) Retrieval of Intermediate Data after 
Cotiditionalization 

' ' This is an 'intermediate module that is invisible 
to the user.- Its function is to reset tfie per- 4. 
sonal file for bivaniate analysis af^er a condi- 
tional h^s been analyzed. 

Module 19 (CM0DB3) Conditional Expectation* Plot 

" . ^ ; • A conditional ' expectation plqt ptovides a graph • 
t,^^ ' of the 'Gonditlonal means of the. Y-V^rJ-abl^ given* 

a' ser of inteirvals of ,the. variable on the X-a^is. 
" ' *the intrestigator is asked td^nter-Jhe number of 
' 'interval's into which the X-d^tLs'ls to.^bfe divld^dj . 
. The minimum numbed of ' intervals is 10 „ 4nd the 
^ naximum is.' 60. Theni' the Y-values lor any obser- 
vations whose X-vaiifes fall in an interval are 
/ i .averaged and a symbol plotted opposite the appro- 
,1 ^ - priate Y-value and above the approR^riate X-interval. 
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This symtxQl will also give an indication of the 
number of observations upon which the conditional 
mean was^hased* The following symbols were used: 

Number of Observations Symbol Plotted ' 

1 through 9 ' ' digit - 

IQ through 19 - & . 

\p: 20 through 29 * * 

30 or greater $ 

Module 20- (CMODAJ) Standar4ization 

In bivarlate standardization, the. user standardize 
/ both variables to a mean of 0 and standard devia- 
tion of *1, tlihs permitting analysis of, the datB, 
without scale or location effects. Once standard- 
• ization%ias" taken place, ,new variables must be 
selected or the orjginal data retrieved before 
the standardization option may be used again. 

This module provides only temporary alteration of 
the data/ ^^^^ wishes a permanent change 

..of the person^file, this module is not appro- 
priate • For^ermapent changes, use Component 13^ 
Model 1. ' ^ • " 

-Module ili^CCMODAL) Transformatiotj . • - » ' 

'.^ - , ' ^Bivariate transformation allows the investigator 
""tb transform one or Both- of the variables being 
'^examined. The same transformations ^re available 
- In bivatiate EDA as under univariate EDA, The 

transformations are: 



1, Power or Linear 

2, ' Logarittun to specified base 
. Log-odds to specified base 

4, • Arcsine' . ' ' 

\' 5, L6g-:odds of rank, base 10 

Once a bivariate transformation has taken place, 
the' data may rSj^ be transformed again without 
selection of new variables or retrieval of the 
original data* The various transformation oj^tiohs 
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allow an investigator "to transfonrr a wide variety 
of data. Different transformations jnay be 
applied to the X and Y variables. 

This module provides only temporary alteration of 
the data. If the user wishes a permanent phange 
ofi'the personal^f ile, this module is nonappro- 
priate. For p.ermanent changes, use Component 13, 
Model 1., 



^Module 22 (CMODAM) triraiaing 
i . 

In bivariate trimming, the investigfiftor is allowed 
to trim either or both of the variables. The 
investigator may first trim up to 15 percent of 
the observations from the high and/or low end of 
the X variable. The percentages trimmed off the ' 
two ends may be different. Aft^r this. trimming, 
the new number of observations is presented and 
the Y variable'may then be trimmeS in a like 
^ manner. . (In this case, the percentages to be •* 
specified refer to the. observations that remain 
after trimming on X, Thistall<?ws the investigator 
a wide latitude in what is being trimmed,) 

This module 'provides only temporary alteration 
of the data. If the user wishes' a permanent \ ^ 
change of the personal file, this module is naf , 
appropriate. For permanent changes, use Component 
12,, Mod^el^^2^' • i 

Module 23 CCMODAN) .Retrieval aft'er Alteration 

The retrieval option of bivariate EDA allows the 
invesflgi^tor to get back the data that were 
available ^efore^eing altered by standardization, 
trimming, Ind/cyr transformation.* The names of the 
original variables and the number of observations 
are presented to the user before being returned 
to'^^the menu. 

•Module 24 (CM0D13) Summary Statistics 

This module provides .summary statistics of all ^he 
variables in the personal f,ile» ' See the explana- 
tion of Component 81, Model 1, Module 15. 
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dis'ribution. , In addition, percentiles can be obtained 
for truncated t distributions. Subroutine TDTR is 
used for calculation. of the CDF. 


> • 


Module 


3 


(CMODD) Inverse Chi Distribution 


• 

• 

• 


• 


• 


Thi^ module enables the user to study an inverse chi 
distribution after- entering the degrees of freedom and 
the scale parameter. Options available are the same as 
for the normal distribution. Probabilities and 
percentiles are calculated by converting the inverse 
chi into a chi-square. The module uses subroutines 
CSQDTR for calculati6n of' chi-square CDF and ICHDR for 
calculation of HDR. 


> 

• * 


Module 


4 

» 


(CMODN).' Inverse Chi-Square -Distribution 

This moduj-e provides information about^ari inverse chi- ^ 
square distribution after the degrees of freedom and ' 
the scale T^rameter are entered. Options are the same 
as for the normal distribution Reciprocal of the 
inverse chi-square is used for computation of proba- 
bilities and percentiles • Subroutines employed are 
CSQDTK for chi-squar^ CDF'and ICSQHR for calculatirfn 
of HDR. . ' 




' Module 


5 


(CMODO) Chi-Square Distribution ' . 








This module is used to study a chi-square distribution 
after entering the degrees 'of freedom and the scal^e 
parameter. The same options are available as with the 
* normal distribution. The module uses subroutine CSQDTR 
for* calculation of probabilities and CSQHDR for highest 
density regions. 


1 


Module 


6 


(CMODB) Beta Distribution 

* This module allows the user to investigate a two- 
parameter beta distribution after the parameters have 
been entrted. The same five options as 'in the narmal 
distribution are available. Subtoutines used are 

'bDTR for calculation of CDF and BI5)R for highest^ 
diensity regions . 




Module 7 


(CMODF) 'Behr ens-Fisher Distribution 


/ 

% 






This mpdule enables the user to study a Behrens-Fisher 
distribution, which 'is the distribution of the 
difference of two independent t distributions. Two 

• * 
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dis'ribution. , In addition, percentiles can be obtained 
for truncated t distributions • Subroutine TDTR is 
used for calculation. of the CDF- 
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Module 3 (CMODD) Inverse Chi Distribution 

Thi'B module enables the user to study an inverse chi 
• . distribution after- entering the degrees of freedom and 

the scale parameter. Options available are the same as 
for the normal distribution. Probabilities and 
• percentiles are calculated by converting the inverse 

chi into a chi-square. The module uses subroutines 
' . CSQDTR for calculatibn of chi-square CDF and ICHDR for 
calculation of HDR. 

Module 4 (CMODN).' Inverse Chi-Square -Distribution 

, This module provides information about^ari inverse chi- ^ 
square distribution after the degrees of freedom and 
the scale parameter are entered. Options are the same 
as for the normal distribution Reciprocal of the 
inverse chi-square is used for computation of proba- 
bilities and percentiles. Subroutines employed are 
CSQDTS for chi-squar^ CDF'and ICSQHR for calculation 
of HDR. ^- . * 

Module 5 (CMODO) Chi-Square Distribution 

This module is used to study a chi-square distribution 
after entering the degress of freedom and the scal^e 
parameter. The same options are available as with the 
* normal distribution. The module uses subroutine CSQDTR 
for* calculation of probabilities and CSQHDR for highest 
density regions. 

Module 6 (CMODB) Beta Distribution ^ 

' This* module allows the user to investigate a two- 
parameter beta distribution after the pai^ameters have 
been ent^ed. The same five options as 'in the normal 
distribution are available. Subroutines used are 
, *BDTR for calculation of CDF and BipR for highest 
density regions. 

Jlodule 1 (CMODF) -Behr ens-Fisher Distribution 

This mpdule enables* the user to study a Behrens-Fisher 
distribution, which 'is the distribution of the 
difference of two independent t distributions. Two 
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options- are available for entering -parameters. The user 
may enter degrees of freedom, mean, and scale parameter, 
for each t distribution. In the other option one 
specifies the two degrees of freedom, angle t|> , mean 
and scale for the Behr ens-Fisher. Options available 
are the same as for the normal -distribution. Calcu- 
lations are carried out by approximating the • 

distribution with a Student's t (Patil, 1964); 
> . •» „ 

( 

Module 8 CCMODZ) F Distribution 

This module allows the user to study an F distribution 
after the two degrees of freedom (v , v^) and two scale 
parameters (X.,X_) are entered, (v ,xp refer to the 
^ -inverse chi-square in tHe denominator. The same 

opti6ns as for the normal distribution are available. 
Probabilities and percentiles are calculated by' 
trariaformirig F into a beta variable. * • 

Module 9 (CMODV) Binomial Distributions ^ „ 

This module enables the user to study a binomial 
distribution with specified size and' process parameters. 
3Vp options are available: ' ' , 

■ 1. Probabilities that the number of successes 
wi,ll be less thap X, equal to X, and greater 
than X. ' 

2. Probability that the number of successes will^ 
be at least XI but not- more than X2. 
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Cumulative probabilities are Calculated. with a normal 
approximation if the parameters and tha argument are 
' such as to make "it accurate* Otherwise the module 

computes sums of individual terms.' 

Mqdule 10 (CMODW) Pascal Distribution 

This module enables the user to investigate a Pascal . 
distribution after entering the success and process 
^ *^ parameters. Options available are the same as for 

the binomial distribution. Normal approximation or . 
direct summation is used,^ depending on the values of 
parameters and the argument. 

Module 11 (CMODX) Befta-Binomial Distribution' ^ ■ ^ I 

This module enables the user to study a beta-binoiial . 
distribution after specifying the number/f observations 
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and parameters vf the beta distribution. The same 
options are availaijle as for the binomial distribution. 
\ ^ • . Probabilities ar^ computed by an interative procedure 
(Lord & Novick, 1968); with a Stirling approximation 
for the gamma function. 

Module 12 (CMODY) Beta-Pastal Distribution 

This module enables the^Ser.jto gamine a beta-Pascal • 
distribution after entering the number of successes 
» ahd parameters of the beta distribution. Options ^ 
* available are the same as for the binomial distribd*-- 

tion. o *i 



Module 13 (CM0D55) Poisson Distribution 

I 

This module is for study--^of a Poisson distribution 
with a specified mean. Options are the same as for 
the binomial distribution. The^ CDF is calculated* by . 
% summing.. individual terms which are computed by 
iteration. 

i ' - 

Module lA (CMOD57) Gamma- Distribution 

The gamma distribution is the same as the chi-square, 
except that parametets ar^e defined differently (Novick 
& Jackson, 1974) . The module accepts parameters of ^ 
the. garatoa distribution, converts them into those' of 
the chi-aquare distribtuion, and then proceeds as in 
.CMdbO. • 

Module 15 (CM0D9B) Bivariate Normal Distributdoh. 

this module allows the user to investigate a bivariate 
normal distribution after: entering the means, standard 
^ deviations, and correlation. Following options are 

available: , 



1. Probability that X Is less than XO' and Y 
is less thatt ^0 . 

2. Contour plot ^of probability. density function 

3. ' Highest density -regions 

4. Conditional distributions^^ 

5. Marginal distributions ^ . ^ 

6. . Plot of cumulative distribution (as in 

Option 1) • . • , , " 

✓ ^ ' ' - 

Jh±3 module provides the mean and standard deviation 
of a conditional or marginal distiJLl)ution.** If the 
user wants' to study the di^ribution in .detail, the 
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modxile uses CMODE as a subroutine . The module uses 
NDTR for univariate an4 BINORM for bivariate normal 
■ CDF. , ' ' 

Module 16 .(CM0D91i) Multivariatte Normal Distribution 

This module' provides information about a multivariate 
normal distributibn whose means and variance-covariance 
matrix are given. For .the! relevant theory see 
Anderson/ 1958. The options are: v 

^. • 1. Highest density regions 

2. Univariate conditional distributions 
■ 3. TJnivariate marginal distributions 

This module provides t^e mean and standard deviation 
of a conditional or marginal* distribution. If the user 
wants to ^study. .the distribution in detail, the module 
uses CMODE as a subroutine. 

Module 17 (CM0D9M) Multivari,ate -t Distribution 

This module enables the user to study a multivariate , 
t distribution. after entering the degrees, of freedom, 
- ■ , means, and the variance-covariance matrix. Options 

are the same as for the multivariate normal distribu- 
tion. For relevant theory see Box and Tia^, 1973. 

Module 18 (CM0D9S) Dirichlet (Multivariate Beta> Distribution 

This module provides the parameters, mean, standard 
deviatiotT* and mode of any univariate marginal 
distribution, which ijs a two-parameter beta. If more 
detailed study of the marginal distribution is, desired,, 
CMODB is used as a subroutine .- 
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VII. LISTING OF THE CADA PROGRAM MODULES 

• • • 

Cada Modules are made up of a chained sequence of programming 
t^elem^ts called CMODs. These are the building blocks from which 
^model^/are constJ;ucted^ The function of th^ supervisory CMODs (e.g., 
CADA, CEXPLN, CMONTR, and so- oh) Have been explained. (See sections 
IV and V). The following is a list of tl>e CMODs aj^d a brief .descrip 
tion of each Inodule.. ^ ' , ' 

V 

CADAr Initialization of the p^ersonal file and system parameters 

CEXPLN ' Explanation of CADA • - 

CMONTR ' ControT~of branching for the model and module levels^ 



CMPGRP 
RSTRT 



Control of branching for the component apd C9mponent group 
levels ^ ' , , ' 



Control of branching for restart 
CERROR Handling of unexpected errors 
COMPll Control of the Data Structures component 
C0MP12 Control of the Data Movement component 
C0M13 Control of the Data Transformations component 
C0MP14 ( Control of the File Maintenance component 

■ • J 

COl!PZL Control of the fiinary Models component * 

C0MP22 Control of the^Univariate Normal Models component 

COMP23 Control of the Multicategory Models component ^ ' , • 

C0MP24 Control of the Simple Linear Regression Analysis component 

C0MP25 Control of the Multiple Linear Regres^sion Analysis 
component 

C0MP31 Control of the Utilities and Expected Utilities component 

%COMP32 Control of the Educational and Employment Selection 
component 

"* * 

COMP33 Control of the Selection of Educational Treatment component 
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C0MP41 Control^ of the Simultaneous Estimation of Proportions 
; . component* 

C6MP42 Control of^ the Simultaneous Estimation of Means component 

C0MP43. Control of the Simultaneous Estimation in M Groups component 

C0MP51 Control cf the Full-Rank Model I ^aly^is of Variance 
component 

C0MR52^ Control of the .Bayesian Analysis of Repeated-Measures 
Designs component > 

C0MP61 Control of the Bayesiai^, Full-Rank flultivariate Analysis of 
Variance component ^ 

C0>iP71 Control of the Frequency , Distributions component 

COMP72 Control of the Summary Statistics component 

COMP73 gontrol of the Graphic Displays pbmponent 

COMP74 Control^of thevRegression component 

C0MP81 Control 6f the Univariate Exploratory Data Analysis component 

C0MP82 Cojvtrol of" the Bivariate Exploratory Data Analysis component 

.C0MP91 Control of the Evaluation ' of Probab'ility Distributions 
component 

> 

CM0D2. Beta prior distribiftion ^ : 

# » 
CMODS Beta posterior distribution 

CM0D4 Prior distribution for two-parameter-nprmal standard 
deviation' ^ ^ ^ 

^CM0D5 Prior' distribution fqr two-parameter-normal mean 

' CM0D6 Posterior distribution for two-parameter normal 

CM0D7' Explanation for comparison, of two normal meanp ^ ^ 

CM0D8 '■ Specification of typical prior form-group proportions, ^ 
using airesine transformation . 

CM0D9 Posterior distribution for m-&roup proportions, . using 
arcsine transformation . ■ 
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CMODll Data entry from the terminal ^ 

CM0D12 Data display and editing 

CM0D13 Summary statistics 

CM0D14 Data graphs and tabulat displays 

CM0D15 Contrcrt for nullary, *unary^ and binary operations 

CM0D16 Set-up module foi^ data grouping ' 

CM0D17 Data transfer to disk 

CM0D18 Data transfer from the catalog 

CM0Ii20 Catalog data-set loading . 

CM0D22 Consensus preposterior analysis for two-parameter normal 

CM0D30 Required but missing data set in the personal file 

CM0D31 Data transfei^ from disk 

CM0D42 Bivariate plots 

CM0D43 Absolute frequency histograms 

CMOD55 Evaluation of Poisson distribution 

CMOD57 ' Evaluation of gamma distribution 

CM0D61 Working module for data grouping 

CM0D62 Equal-slopes model for simultaneous prediction in m-group£ 

CM0D63 Predictive distribution, equal-slopes model, simultaneous 
prediction 

CMOD64 Adversary^ preposterior for two-parameter normal ' 

CMOD65 Prior for simple linear regression 

CM0D66 Posterior on slope and residual standard deviation 

CMqD67 Posterior predictive distribution 

CM0D76 Prior distribution for simultaneous estimation of means 

CMOD77 Eosterior analysis for simultaneous estimation of means 
« 

I ' ' . 101 . • 
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CM0D90 Determitiation of cut score for one-grput) selection 

CMDD91 Preparation for assessing 'utilities in two-group restricted 
selection * . 

* 

CM0D94 Presimultaneous estimation module 
CM0D98 Stem-and-leaf for univariate 
CM0D99 Box* plot fpi? univariate EDA 

CMODA ' Posterior analysis for m-group proportions using arcsine 
transformation 

CMODB . Evaluation of a beta distribution 

CMODC Evaluation of a Student's t distribution 

CMODD Evaluation of an inverse-chi distribution 

'CMODE Evaluation of a normal distribution ^ 

CMODF Evaluation of a Behrens-Fisher distribution > . 

CMODG Prior* ,for multinomial Diricblet 

CMODH Posterior multinomial Dirichlet i 

CMODJ Entry of indifference probabjLlities for flxed-s^:ate utility 
assessment 

CMODK * Estimation for fixed-state utility assessment 
CMODL Fit of 'normal and t utility functions 
vCMODN Evaluation of an inverse chi-square, distribution- 
CMODO Evaluation of a chirsquare distribution 
CMODQ Explanation for fixed-state utility assessment 
(JMODR Control of the evaluation of utility functions ^ 
CMODT * Independent beta-distributed proportions 
CMODU Comparison of two standard deviations 
CMODV , Evaluation of l^inomial distribution 
-CMODW EvaXuation of Pascal distribution 



ERIC 



102 



1,05 



CMODX Evaluation of a beta-binomial d^.stribution 

CMODY Evaluation of a beta-Pascal distribution ■ j 

CMODZ Evaluation of an F distribution * 

CM0D9A Empirical CDF for univariate EDA 

CM0D9B Evaluation of» bivariate normal distribution^ 
« — ' v 

CM0D9C ..Least squares and Bayesian estimates, simultaneous 
estimation * ' • ' 

CMQ^9D Selection of variable for univariate EDA 

CMQD9E Selection of analysis for univariate EDA 

CM0D9H Empirical PDF for univariate' EDA ■ . 

CM0D9I " Normal probability *plot fqr univariate 5DA 

CMpDSLJ ' Smoothed empirical PDF for univariate EDA 
r 

GM0D9K Standardization for univariate EDA , 
CM0D9L Evaluation of multivariate normal distribution 
CM0D9M Evaluation of multivariate t distribution 
CM0D9N R^rieval of original Da^ for univariate EDA 
sCM0D90 Transformation of Univariate EDA 
CM0D9P A'ssignment with threshold utility assessment 

CM0D9Q^ Optional assessments for assignment to educational 

treatments . ^ 

• * ♦ 

CM0D9R Restricted selection with simple or multiple predicto 
'CM0D9S Evaluation of Dirichlet distribution 
CM0D9V Selection of variable? for bivariate EDA 
CM0D9W , Trimming for univariate EDA 

CM0D9Y • Determination, of cut score for r^strict^d selecdon 
CMODAl . Selection of analysis* for bivariate EDA - 
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CM0DA2 Explanation* of scatter ^lot for bivairiate EDA 

cyODA3 Questions for univariate EDA 

CM0DA4 Description of univa^ate EDA 

^M0DA5 Desci;iption of bivariate* EDA 

, ^ . 9 

CM0DA6 Questions for bivariate. EDA 

CM0DA7 Scatter' plot for bivariate EDA 

CM0DA8 Schematic plot explanation' for bivariate EDA 

CM0DA9 . Summary statistics for bivariate EDA 

CMODAA Prior for beta-Pascal model 

CMODAB Preposterior for beta-binomial model 

CMODAC Posterior for beta-Pascal model 

. CMODAI Schematic plot for bivariate EDA 

CMODAJ Standardization for bivariate EDA ^ 

CMODAK Conditionals for bivariate EDA 

CMODAL Transfonnation for bivariate EDA 

CMODAM Trimming for bivariate EDA 

' * * • 

CMODAN Retrieval of original data for bivariate EDA I 

CMODAO Generalized beta-cumulative utility fit 

CMODAP Retrieval of data after conditional for bivariate EDA 

CMODAR Control and evaluation of least-squares utility functions 

CMODAS Selection of conditional analysis foy bivariate EDA ^ 

CMDDAT Expected utilitiea 

CMODBl. Least-squares set-up for classical linear regression 

CM0DB2 Analysis of classical linear regression 

CM0DB3 Conditional expectation plot 

CMODBA Conditional-utility preliminary assessment 
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CM0DB5 Entry of previously'--assessed conditional utilities 
CM0DB6 Expected utility 'for conditional utilities 
CMQDB? Regional-coherence Aitility asses;3ment 



CM0DB8 Local-coherence utility assessment 

. • ^ - . \ r ' • 
> CM0DB9 Explanation and selection of conditional-utility assess- 
ment * 

CMODBA Explanation and entry for regional-coherence assessment 
CMODBB Explanation and entry for local-coherence assessment 
CMODBC Threshold utility assessment 
CMODBD Control of assignment ,to treatments 

CMODBE Assessment of utilities for two groups: scaling the two 
utilities ^ ^ ' \ . ' 

CMODBF Twa-treatment assignment 

CMODBI Assessment of utilities for two groups 

CMOD^J Assignment to treatments 

CMODBK Selection of applicants, prediction from sample dat^ 
CMODBL Control of restricted selection ^analysis d 
CMODBO Explanation of matrix operations 
CMODBP Standard and special ma-trix operators 

,CMODBQ "~ Matrix management 

CfiODCl Explanation of assessment procedure and entry of variable 

/ . ^ ' . , 1 , 

CM0DC2 Estimation of central tendency of the distribution of the 
regTSession coefficients 



CM0DC3 Hypothetical^data method for the estimation of the sc^le 
factor and dispersion matrix 

CM0DC4 Display of the distributions for variance of error and 
' regression coefficients 

CMODpS ' Selection of variables from sample dat^ and entry of prio 
* ' information 
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CM0DC6 

CM0DC7 

CM0DC8 

CM0DC9 
CMODCA 
CMODDO 
CMODDl 
CM0DD2 
CM0DD3 
C>©DD4 
CM0DD5 
CM0DD6 

CM0DD7 
CMODDAr 

CHODOB 
CMODDC 

4 

CMODDD 
(?10DDE 
CMODDF 
CMODDG 
CMODDH 



Computation and display of the posterior distribution for 
variance of error and regression coefficients * ^ 

Further .examination of the posterior distributions for 
variance of error and regression coefficients 

Display of observed and predicted criterion values for , 
sample 'data*. 

Storage' df par^m^ters from regression equation 
Determination of cut scores for each assignment 

4 ^ f 

Determinatiop^^of^esign lay-out from raw data for MANOVA- 

Assembly of, summary statistics for ANOVA 

Entry of s^immary statistics from the terminal for ANOVA 

Generation of main effects and interactions for ANOVA 

Tutorial on main effects and interactions for ANOVA 

Analysis of posterior t-dfstributions of effects for ANOVA 

Calculation of probability content of smallest highest 
density region (HDR) for ANOVA 

Tutorial on highest density regions (HDRs) for ANDVA 



Entry of ^Bt^mmary statistics or priors parameters frqm 
terminal for MANOVA ^ 

Compute parameters of po|Jterior distribution for MANOVA 

Definitions of main effects for MANOVA 

Examination of the posterior matric t distribution for 
MANOVA 

(ilSntinuation from QWDDO: compute summary statistics for 
MANOVA ; 

- ' 

Continuation from CMODDO: collect lay-out design^from 
terminal for MANOVA 

Continuation from CMODDC: compute transformation 'matrix 
for effects for MANOVA 

Continuation from CMODDD: collect parameter statistics 
for HANOVA 
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CMODDI Continuation, from CMODDD: sweep operator for MANOVA 

CMOliDJ Continuation from CMODDD: beta distribution, approximate 
* ' ' " content of HDR for MANOVA > ' 

CMODDK Tutorial I for MANOVA 

CMODDL Tutorial II for MANOVA *; 

CMOPDM Stor.age of . parameters for.'ANOVA and MASQW 

CMODEO * Explanation for nullary, unary , ^nd binary operations 

CMODEl Operation definition for nullary, unary, and binary 
operations , 

CM0DE2 Operation execution for nullary, unary and binary opera- 
tions fL ' 
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VIII. LISTING OF ^ADA PROGRAM MODULES AND DATA FILES 
REQUIRED. FOR EACH CO^ffONENT GROUP / . 

• Many CADA users have only small disks available on their compu- 
ters and therefore can 'not store all of CADA either in memory or on 
disk. Because 'the number of CADA users having access to such comirta- 
•tera is increasing, CADA -has been segmented into component groups. 
This hafi been done in such- a way . that usually only the control 
.programs and one component group need be loaded at one time. 

In this section, we list the modules needed for each of the 
component groups. Users who wish to load only a portion of CADA 
should follow the special loading instructions provided in se(?tion 
XI and the instructions provided with CADA, using the information 
given here as to what, modules are needed for each -component group. 



A 
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Component Group 1 
Data Management Facility 
— Mpdules Needed — ^ 



Control 



CERROR 



CM0D30 CMONTR CMP.ORP 
C0MP12 C0MP13 C0MP14 RSTRT 
Component 11. Data Structures (not yet implemented) 
Component 12. Data Movement 



CM0D12 



CM0D17 



CMODll 
CM0D31 

Component 13. Data Transformations 

*CM0D13 CM0D15 -CMODBO 
CMODEO CMODEl CM0DE2 
Component 14. File Maintenance 
CM0D16 CipD61 
*Also accessible from component groups 7 and 8. 

— Data Files Needed — 
AO, Al, ... (Personal Files) 
FILEl • 



C8LL9 

C^L15 

C9LL9 



CM0D18 



COMPll 



CM0D20 



CMODBP CMODBQ 



C9LL15 
\ 



FILE2 


- FILE 3 


PILE4 


FILES 


FILE7 


' C8LL6 


C8LL,7 ■ 


C8LL8 


C8LL10 


C8LL11 


_ C8LL12 


'C8LL13 


C8LL19 


C9LL6 


C9LL7 


, C9LL8 


C9LL10 


C9LL11 


C9LL12 


C9LL13 


C9LL19 


DFILOl 


DFIL02 


. . • 
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^ Component Group 2 
Simple Bayeslan Parametric Models 
— Modules Needed — 



Control . CERROR CMOD30 CMONTR CMPGRP 
C0MP22 COMP23 COMP24- COMP25 
Component 21. Binary Models 

CMDD2, CMOPS CMODAA CMODAB 
• *CMDDb' CMODT *CMqDX *CMODY 
Component 22. Univariate Normal Model* 

CMDD4 CM0D5 CM0D6 CM0D7 
CMOD64 *CMODC *CMODD *CMDDF 
Component 23. Multlcategorlcal Models 

CMODG CMODH * 
Component 24. Simple Linear Regression Analysis 

CMOD65 CMOD66 ' CMOD67 QI0DC9 
Component 25. Multiple Linear Regression Analysis 
CMODCl CM0yC2 CM0DC3 CMDDC4 
CM0DC6 CM0DC7 CM0DC8 , CM0DC9 
*Al80 accessible from Component Group 9. 

— Data Files Needed — 



AO, Al, ... (Personal Files) 
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Component Group 3 A 
Decision Theoretic Models 
— Modules Needed — 



Control 



Component 31. 



CMPGRP C0MP31 



CMODBA 



CMODR 
CMODBB 



CERROR CMOD30 dkoNTR 
COMP32 COMP33 RSTRT 
Utilities and Expected Utilities 
CMODJ CMODK CMODL CMODQ 
CMODAO CMODAR CMODAT 
CM0DB7 CM0DB8 
Component 32. Educational and Employment Selection 

CMODAO CM0D91 CM0D9R CM0D9Y CMODBC 
X CMOpBE CMODBI CMODB% CMODBL 

Component 33. Educational and Employment Assignment 

CM0D9P ' CMob^Q CMODBD CMODBF CMODBJ 
CMODBA CM0DB5 CM0DB6 CM0DB7 ' CMODBB 
CM0DB9 CMODCA 
★Component Group. 2 must be loaded to use this component group 

— Data Files Needed — 
AO, Al, ••. (Personal Files) 
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t 


# 

Control 




• 

ft . 

/ 

Component Group 4 ^ . , 
Bayeslan Simultaneous Estimation 
— Modules Needed 

CEEROR 'CMOD30 CMONTR CMPGRP C0MP41 . . * , 
C0MP42 / COMP43 RSTRT 




Component 


41. 


Simultaneous .Estimation of Proportions 

CM0D8 CMOD^ CMODA , , . » 




Component 


42. 


Simultaneous Estimation ,of Means 
* CM0b76# CMOD77 




Component 


43. 


« 

Simultaneous Estimation in m-Groups - 








CM0D62 ' CMDD63 .CMOD94 CM0D9C v ' 
— Data Files Needed — 














AO, Al, ... (Personal Files) 




• 


1 


* • 




* 


1 


< 

• 

* 


• 






1 
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Component Group 5 
1 , Bayesi^n Full-Rank ANOVA 
-r- Modules Needed ^- 
Control . CERROR . CMOD30 CMONTR CMPGRP C0MP51 

C0MP52 -RSTRT * 

* V r 

Component 51. Full-Rank Model I Analysis of Variance 

CMODD 1 ' CMODDf , CM0DD3 CM0DD4 CM0DD5 
CM0DD6 CM0DD7 CMODDM . 
♦Component 52/ Bayesian Analysis of Repeated-Measures Designs 
GMODDO CMODbA * CMODDB CMODDC CMODDD 
CMODDE CMODDF CMODDG CMODDH CMODDI 
CMODDJ CMODDK CMODDL CMODDM 
^Component 52 is essentially the %ame as Component 61. 

— Data Files Needed — 
■H , ^ AO, Al, (Personal Files) 
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Component Grgup 6 
Bayeslan Full-Rank Multivariate Analysis 
— Modules Needed % — 

Control CERRO» CM0D30 . CMOStR . CMPGRP C0MP61 

RSTRT 

Component 61* Bayesian*- Full-Rank Multivariate Analysis of Variance 
CMODDO CMODDA CMDDDB . CMODDC CMODDD 
CMODDE^ CMDDDF CMODDG CMODDH CMODDI 
CMDDDJ CMODDK GMODDL ^MODDM 

♦Component 61 is essentially the same as Co^onent 

— rfeta Piles Needed — 
40, Ai; ••• (Peraional. Files) 



11.7 



Component Group 7 ^ 
Classical Elementaryf Statistics 



— Modules Needed — 



L 



CMPGRP 
RSTRT 



ontrol ' CERROR CM0D30 CMONTR 

ii 

. . I 

COMP72 _COMP73 COMP74 

Component 71. Frequency Distributions 

' CM0D14 CMOD43 | 

Component 72. Stimmary Statistics 

*CM0D13 * _ ' ' 

Component 73. Graphic Dls^)lays 

CM0D42 QIOD43 

Component 74.* Regression 

CMODB 1 CMODB 2 *CM0D1 5 CM0D9ljf 

*Also accessible in Component, Groups 1 or 8. 

i . ^ *• 

— Data Files Needed ~ 

- , AO, Al, ... ^Personal Files) 



C0MP71 



CMOD42 



i 
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Component GroXip .8 
E^loratory Data Analysis 
— Modules Needed — 



Control CERROR ^D30 CMONTR CMPGRP / C0MP81 

COMP82 . RSTRT . 
, Component 81 • Univariate Exploratory Data Analysis • 



*CM0D13 


CMbD98 


CMOD99 


CM0D9A 


CM0D9D 


CM0D9E 


CM^H 


CM0D9r 


CMdD9J 


CM0D9K 


CM0D9N 


CM0D90 


CM0D9W 


CM0DA3 


CM0DA4 


Bivariate Exploratory Data Analysis 




*CM0D13 


CMOD98 


CMOD99 


CM0D9A 


CM0D9H 


CM0D9I 


CM0D9J 


CM0D9V 


CMODAI 


CMDDA2 


CM0DA5 


CMOpAe 


CM0DA7 


CM0DA8 


CM0DA9 


CMODAI 


CHODAJ 


CMODAK 


CMODAL 


CMODAM 


CMODAN 


^CMODAP 


CMd6AS 


CM0DB3 





*Al80 accessible in Component Groups 1 and 7. 

— Data Files Needed — 
V * AO, Al, ... (Personal Files) 
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tjontrol 



Component *GrQup 9 
Probability Distributions 

' V ' — Modules •Needed — 

* 

CERROR^ CM0D30 C^IOl}TR 

• rstrt" 



CMPGRP C0MP91 



Component 91. Evaluation of Probability Distributions 



CMOD55 


CMOD57 


*CMCa)B 


*CMODC 


*CMODD 


c 


GMODE 


*CMODF 


cmodn" 


piODO 


.CMODV 




CMODW 


*CMODX ' 


*CMODY 


CMODZ 


CMPD9B 




CM0D9L 


;}M0D9M . 


CM0D9S 




•* 


i 



*Also accessible in Component Group 2*. 

— Data Files Needed — 
" AO, Al, (Personal Files) 
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IX* COMPUTATIONAL SUBROUTINES 



Since many mathematical maijipulations are the same from module 
to module, CADA^s data analysis routines have been built in a sub- 
routine manner/ A large percentage of the computation done by CADA 
involves the U9e of 16 computational subroutines. The following is 
a list of these 16 subroutiVies, together with a brief description of 
the computational methods. they employ.^ ' . * • 



Subroutine 
BDTR 
BHDR 
filNQRM 

BISORT 
CSQDTR 
CSQHDR 
ICHDR 
ICSQHR 
INP6HR 
. INPNUM 

NDTR , 

PFOPEN 

SORT 

TDTR 

THDR 



Description 

Beta cumulative distribution function (CDF) 

Beta highest density region (HDR) 

Bivariate normal cumulative distribution function 
(CDF) 

Sort bivariate data 

Chi-square cumulative distribution function CCDF) 
Chi-square highest density region (HDR) 
Inverse-chi highest density region (HDR) 
Inverse-chi-square highest density region (HDR) 
Character input from the terminal 
Numeric input from the terminal 

• c 

Natural logarithm of the gamma function 
• Normal cumulative distribution functloll (CDF) 

I 

Open the personal file 



Sort univariate data 

Student's t cimiulative distribution function (CDF) 
Student's t highest density region (HDR) 



118 



BDTR ^ ' . ^ 

* Tt^s subroutine calculates . the cumulative distribution function 
(CDF) of a beta distribution. Arguments consist of -parameters A -and 
B of the distribution, and the value J2 where the CDF^ desired. 
The result is returned in variable ?• *^ , 

If A or B is less than^S, the distribution is assumed to- be 
apprc&clmately nottaal when (A+B) exceeds 85; otherwise 16-point . 
Gaussian integration is carried out. Peizer-Pratt approximaeion is' 
used when both A and" B are at least 5 (Peizer & Pratt, 1968). 

A GOSUB to initialize .the Gaussian .constants is needed once 
before this subroutine is called for the first time,^ After the . 
» parameters A and B are entered, a GOSUB is needed to calctilate the 
normalizing ^constant FO for the beta distribution. FO is the log ^of- 
the reciprocal of the complete beta function. * 

Arrays used kre 0 and W which contain the points and weights 
for Gaussian integration. Scalars used ^re A, B, C6, C7, PO, Dl, 
D9, FO, GO, G9, J2, P, RO. Subroutines called are NDTR for normal 
CDF and LGAM for log -gamma. , -^^^^-^ 

_ J. . ■ ■ . . 

BHDR ^ 

This subroutine calculates highest density regions fdr a beta 
distribution. Arguments consist 'of parameters A and B of the 
distribution, and the probability J5 contained ,in the HDR. Both A ^ 
and B must exceed 1 for^ HDR to exist. The IcJwer and upper end 
points of the region are returned in Jl and'J2. 

The logic is based on the. formula giv6n by Jackson (1974) for 
Jl and a2 as functions of the ratio d = J1/J2. Let y and a be the 
mean and standard deviation of the distribution. The initial value 
for d is (y+1.6aJ5)/(y-1.6aJ5). Jl, J2 and the probability between 
them are calculated. The flewt^-Raphson procedure is used to 
improve the v^ue of d'until Wfe probability between Jl and J2 is 
^within .0001 of J5. , , ' 

Scalars used are A, A9, B, C, J, Jl, ^2, J3, J4, J5, J6, J7, J8 
P, PO, P9, UO. Subroutines needed are BDlR^for beta CDF, NDTR for 
normal CDF, and LGAM for log gamma. - f 

BINORM • ' . 

This subrouti-ne computes the probability in the -regioru-(X<H, 
Y<K) of a standard bivariate nomal distribution. Argents con- 
sist of t^ha correlation R and fhe values H, K. The -pribability is ■ 
returned in S. *' ^ , 
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Probability is calculated by summing the first ^ terms of the 
tetrachoric series of Pearson (1900). 



Arrays used are T, V, W. Scalars used are H, 
06, 07, 08, P, P2, Q3, R, R9, S. Subroutine NDTR 
calculating univariate normal CDF. ' 



HI, I, K, Kl, N,' 
s needed for 



BISORT 

This routine sorts bivariate observations stored in two- 
dimensional array P into ascending order based on the Values of the 
observations in the first column. This is a destructive sort in 
that the original data are not saved. The nimiber of observations 
must be set in variable NO. This, subroutine makes use of a trans- 
position bubble sort-technique (NieVergelt, Jarrar, and Reingold, 
1974). The array P is used, as are scalarsjl^^^^N^^ and RO through" 
R9. ' - / • \ 

« 

CSQDTR ' . ... ' * J*-'' 

This subroutine provides^' the cumulative distribution function 
"of a standard chi-^-square distribution. Arguments are G, the 
degrees of freedom, and X, the point at which CpF is desired. The 
r^esult is returned in P. 

Probability is calculated using the normal approximation of 
Peizer and Pratt, 1968. 

If 

Variables used are B, B3, G, G6, P, P2, T, X, X2. Subroutine 
NDTR is needed for the normal CDF. 

CSQHDR ^ ^ ' 

This subroutine computes highest density regions for a standard 
chi-square distribution. Arguments consist of the degrees of free- 
dom G and the probability J5 In the HDR. The lower and upper end 
points are-returned in Jl and J2. 

For any given length of the HDR, its. end points are calculated 
using the fommlae -of Jackson (1974). Probability between these 
•points is calculated' and compared with J5. The .iterative procedure 
recoanended by Jackson is followed ur^il the probability is_within 
.00001. of J5. * 

4. < V 

Variables used are G, J, JO, Jl, J2, J3, J5, J8, J9, X. Sub- 
routines called are CSQpTR for chi-square probabilities and NDTR . 
for normal' CDF. 
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ICHDR t 

^ This subroutine calculates highest density regions ior a stan- 
dard inverse chi distribution. Arguments are the degrees of freeijom 
G and the probability J5. The results consist of the. lower and 
upper end points Jl and J2. 

The logic of the algorithm is the, same as in CSQHDR. 

Variables are J, JO, Jl, J2, J3, J8, J9, P, X- Subroutines 
needed are CSQDTR and NDTR. " • ' 



ICSQHR 

This subroutine provides highest density regions of a Standard 
inverse chi-square distribution. Arguments consist of G, the 
degrees of freedom, and J5, the probability in ,th€-^R. The lower 
and upper end points of the interval are returned in Jl and J2, 

-cat 

Logic is the same as in CSQHDR. < 

Variables used are J, JO, Jl. J2, J3, J8, J9, P, X. Subroutines 
called are CSQDTR and NDTR- | 



INPCHR 



This routine allows the user to enter a character, string up to 
72 characters long. The calling sequence is: 



GOSUB 9050 



The string is returned in the variable F$. If the character string 
"-9999" is enterled, then RSTRT is called, giving the user the 
opportunity to restart. 



INPNUM 



This routine allows the usfer to enter up to five numbers frw 
•the terminal. The calling sequence is: 



Let 00 « n 
GOSUB 9000 



where n (1< « n< » 5) is the number of values desired. The values 
are returned in 01, 0'2, 03, 04, 05, depending on how many are ' 
requested. If any of the values are equ^l^to -9999, the RSTRT is 
calledi giving the user the opportunity to restart. 
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LGAM ^ 



/ 

/ 



. This subroutine calculates the natural logarltU f ^ 8^,^ 
function at any (positive) values of the argument G9. ^The result 
returned In GP. 

If G9 exceeds 18; a Stirling approxliaatlon for log o£ a 
factorial Is used, with log. (G9) subtracted. (For values of the 

■ Variables used are Cl, 'c2. €3. C4, GO, G5. G6, G9, R8. 



NPTR 

' This subroutine provides the cumulative distribution function 
of a standard normal distribution. The argument Is N3 and the 
result Is P. > 

'The algorithm Is a rational approximation from Hastings (1955, 
p. 169). 

Variables used are Cl, C2, C3, C4, C5, D, N3, N4, P, T, X. XI. 
PFOPEN 

This routine opens the perspnal file and reads three ^V^bers 
IdentSylnHhe module, model, a^ component. It al?o rewrites the 
record If desired. There are three calling sequences: 

1. Open the personal flU and rfead three values from record 1. 

J3 - n 
J2 » n 
Jl » n 
GOSUB 9060 

where n'ls -1 If the u6er desires the corresponding value 
• In the personal file unchanged, and zeto or S^f !Lle ' 
user desires that the value In. the P«'^«°^,f^'^^^^° 
•changed. The values found in the personal file are re 
turned in 13, 12, and II. 

2 Read three values from' the personal file, assumed to l^ve 
b^n previously opened, and .rewrite the values if desired. 
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J3 « n 
J2 « n 
' Jl « n 
GOSUB 9067 

where n, J3, J2, and Jl hve ^the same meanings as before • 
Values are returned in 13, l2,°and II. 

3. Write up to three new values in the personal file. ' 

J3 « n 
.0 J2 = n * 

Jl = n 

GOSUB 9068 • ^ ' 

where J3, J2, Jl and n have the same meanings as before. No 
valuer are returned; I3, 12, and II are left unchanged. 



SORT 

This subroutine sorts univariate observations stored in vector 
Q intp ascending order. 'This is a destructive s^rt since the 
original values of Q are destroyed. The number of observations must 
be set in 'Variable NO. This subroutine. makes use of a transposition 
bubble-sort technique (Nievergelt, Farrar, and Reingold, 1974). Tlje 
array Q is used, as are scalars I, J, NO^ and RO through R4. 



TDTR 

• this subroutine calculates the cumulative* distribution function 
for. a standard t distribution with G degrees of freedom, at t J2. 
The CDF is returned *in P. 

If G =1, the arctangent functioil is used (Abr^owitz & Stegun, 
1964, ^eqn. 26*7.3). Sixteeri-point Gaussian quadratu^re is performed' 
if .G is between 1 and 10. The approximation given by Peizer and 
Pratt (1968) is used if G is 10 or above. P 1 if (G >6T J2 >6) or 
(a< 6, J2> 12). ' , 

/Before the first call to this subroutine^, a OOSUB is needed to 
initialize the constants for Gaussian integration. Arrays used are 
0 and W. Scalars are DO, Dl, D9, FO, G, GO, G9, 19, Jl, J2, N, Nl, 
P. Subroutines needed ^are NDTR and LGAM. 
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THDR 



This subroutine provides the highest density regions of a stan- 
dard student's t distribution. Arguments consist of G, the degrees 
of freedom, and J5, the probability content of the HDR, The upper 
end point of the interval is returned. in J2; the interval is symme- 
tric about zero. The logic is the same as In CSQHDR. 

Variables used are G, Jl, J2, J5, N, P, XO, X2, X9, Z8, arid Z9; 
subroutine TDTR is called. ^ . ' 



# 
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X. DATA FILES 



The CADA Monitor makeS extensive use of data files. Each user 
of the Monitor is temporarily assigned a unique personal file in 
which the data he or she creates are saved during the course of a 
CAS)A session* This file gives the user the capability* to move from 
module to module, model to model, or component to component, without 
losing pertinent data* However, when the user finishes his or he^ 
current run of CADA, these data are lost, 

Another type of data file associated with CADA is the permanent 
data file. There are 36 permanent data files provided with the 
Monitor.' Of these, 27 contain data sets that are*accessed from 
(Component 12, model 1, module 3, Data File Catalog, and were pre- 
viously explained. The other nine data files are for storage of 
uset data-sets. Th^se have passwords 'associated with them and can 
only be accessed by a user with the correct password.. These nine 
files are: DFILOl, DFIL02, DFIL03, DFIL04, DFIL05, DFIL06,r DFIL07, 
DFIL08, bFIL09. .The passwords are the first entry in each file and 
consist of a six-character string. A list of th^ data files is in 
Table 2. Reading and writing data to and from files are highly , 
system-dependent . Although CADA has the facilities on our develop- 
ment system for reading and writing data to external files, this 
capability may not be implemented on all systems. CADA expects 
the following* format for all of the above files: ^ 

P$ = password (6 characters) / 

N$ = data-set name (6 charactfers) 

GO = nlimber of groups (0 if not grouped data, maximum is 12) 

VO « number of data elements (maximum is 5) • 

G$ « group names (72-ch&racters maximum,' 6 chairaeters per 
name) " ' 

1 

V$ = data element names (30-characters maximum, 6 characters 
per name 

N, » group counts *(12 , numbers, one for each possible group; 
zeros for^ unused, groups) 

D « data '^^^imum 1000 entries stored by variable within 
observation within group) 

The file is assumed to be written by a Basic program. 

N . 

- ^. * * » 
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* * * 

' ' ^ TABLE 


2 




<% 






C9LL6 


r 

ACT- 


1969 


C8LL7 


ACT -.'1968 - School 7 


C9LL7 


ACT - 


1969 


CoLIiO 




HQLLfi ' 


ACT - 


1969 


CoLLJP 


APT _ 1 OAft _ Q/»V»r4rt1 Q 

' 1 




ACT - 


1969 


ot Tin 


. APT • '1 OAfi ^ Qnnnril 1 0 




ACT - 


1969 


C8LL11 


ACT - 1968 - School 11 


C9LL11 


ACT - 


19fe9 


Colli z 


APT 1 OAft mm Qr»Hnn1 1 9 


PQLLl 2 


ACT - 


1^69 


C8LL13 


ACT - 1968 - School 13 


C9LL13 


ACT - 


1969 










1969 


C8LL15 


ACT - 1968 - School 15 


C9LL15 


ACT - 


C8LL19 


ACT - 1968 - School 19 


C9LL19 


AQT - 


1969 


rILEl 


lioby ocnoox X 


'DFILOl 


User 


data' 


FILEZ 


XxOdy ocnoox m 


DFIL02 


User 


dat^ 


T7TT 
FILE J 


17CAA "04 1 nt* PT*n01*flTn Hflt'A 
iSbAA. iriXOL IrJ.Ogt.aiU Ual^tX 


DFIL03 


User 


data 


T7TT V A 


lOWa UOUuLy UELZa 


DFIL04 


User 


data 


FILES 


Sdmple K6gression uaua 


HFILOS 


User 


data 


FILE6 


San^jle ANOvA Data 


m7TT HA 
Ur XLUD 


USci. 




FILE7 


Sample MANOVA Data 


DFIL07 


User 


data 






DFILOB 


User 


data 






DFIL09 


User 


data 



School 6 
School 7 
School 8 
School 9 
Sqhool 10 
School 11 
School 12 
School 13 
School 15 
School 19 
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» There are a number of ways in whici^ data may be^made available 
to CADA. First, users may enter data at''*H;heir terminals via CADA's 
data entry from terminal facility (cQmponent 12, model li module 1) • 
Second, users may add data files to the data Idle catalog. This will 
entail modifying CM0D18 to accept additional d^ta files .Two more , 
data flles^ which must be named "FILES" or "FILE9\ may be added . 
easily. CM0D18 must then be modified by adding tU^the menu of data 
files, by adding additional description or descripj^ons , and by 
changing the check for legal optioa selAtioiT^rom seven to eight 
or nine. If you wish to add more than two catalog data files, 
CM0D20 must be modified as well. 

A third way to make data^i^ailable to CADA is to use the nine 
user data files (DFILOl, DFILE09). You may place your data in 

a data file in the format: described above, name that data file "DFILxx 
(where 'xx' is 01, or 09) and use CADA's facilities for 

retrieving dat^ from user-stored disk files (compoent 12, model 1, 
module 2) . The DFILs must be stored with the rest of the CADA 
system. In addition, you may add the capacity to handle more than 
nine DFILs to CADA. The new DFILs should be named DFILIO through 
DFILnn, where nn <=99; they shoul'd be consecutively ntimbered. You 
must change "DO" in CM0D17 and CM0D31 to reflect the number of 
DFILs allowed. This n\imber is now nine. \^ 

If you create a neW DFIL, or wish to change the password of ^ * 
an existing one, the file must be initialized. CADA expects at 
least a password (maximum of 6 characters) and a blank data-set 
name (maximum of 6 characters). These two strings must be written 
by a Basic program. 
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XI INSTRUCTIONS m INSTALLING THE CADA MONITOR 



i 

Since many users of CADA have limited mass storage, CADA has 
been divided Into nine component groups. It is only necessary to 
load the modules for the desired component group jCand in some 
instances Component Group 2 or' Component Group 9; see section VIII 
for listing of modules and data files for each component group) . 
THLs allows the' user to use a relatively small amount of on--line 
disk space for CADA. A large portipn of CADA ma^ be stored on an 
off-line medium such as magnetic tape and a component group loaded 
to disk only when it i6 needed.* However, this 'does not preclude 
all of CADA being kept on-line, if desired. 

CADA is distributed on the storage medium that we feel is, best 
suited for^ each computer system. This is magnetic tape for ail 
systems for which CADA-1980 is supported. The characteristics of 
data transfer and storage are different for each system and are- not 
listed here. Accompanying each order are instructions for loading 
.CADA to the specified system. These instructions list tKe 
characteristics of the me^ium'and the method fqr loading CADA that 
is the easiest to use. CADA will often be loaded by a utility 
program provided by the manufacturer of the user's computer system. 
However, not all manufacturers provide this facility* If a program 
is not provided by the manufacturer, a set of instructions for 
loading CADA is listed. 
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XII. INSTRUCTIONS FOR USING THE CADA MONITOR 



There are only three system commands that the investigator need 
know to use this^pdckage. These are: a sign-on command, a command 
to 'start the CADA system, and a sign-off command* The sign-on 
procedure varies from system to. system. Once the investigator is 
signed on the system, tha initial module must be loaded and, exe- 
cuted, whiph is usually accompliahed by 6ne command. ..The name of 
the'module^to be executed is CADA. On^the HF 2000 series, the- 
load and execute command is "EXEC-ClUDA" . When finished with the 
system, the "^user must sign otf, usually by typing the command "BYE". 

In addition to the three basic commands, the user should know 
how to use- the Irestart facility in CADA. CADA has a built-in 
restart capability so that if a user wishes to terminate an analysis 
he or she need only type "-9999" when asfced for input. Any neces- 
sary data are retained in the usar*s personal file. The user is 
then given the fol3.owlng options: 

1. start at *the beginning of the module in which he or she is 
now operating (without loss of data in the personal file) ; 

2. , beg in. a new module within the current model; 

3. select a new model within the current component; 

4. choosjB & new component within the current component group; 

5. change 'to a new component ^group; 

6. exit the CADA^Monitor. . 
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XIIJ. DESCRIPTION OF USER PERSONAL FILES 



The length of the personal file assigned to each user is twenty- 
two 512-byte records in the HP 2000 system implemeotatlon. The 
beginning of each record is accessed randomly , but data is accessed 
sequentially within the record. The records^used as entry "points 
are listed in Table 3. • ^ 



TABLE 3 



Records (Entry Points) Sequential File Names 



1 


RFILl 


2 


RFIL2 


3 


, • • , RFIL3 


4 


R^IL4 


5 . , 


RFIL5 


7 


RFIL7 


12 


RFIL12 


14 


RFIL14 


15 


RFIL15 



/ 

Across from each record number is the name of the file used for the 
record in those systems that allow only Sequential access. On 
systems tha^ do not have^ the' ability to pass information to a 
chained module through comnron memory, RFILEO is used to pass 
the terminal screen-erase characters. 

The personal files for the HP 2000 implementation of CADA are 
named AO, Al.," A2, A3, A4, A5, A6, i£7, A8, A9, AA, AB, AC, AD, AE, 
and AF., This allows up td 16 simultaneous users. If you wish 
fewer simultaneous users, delete- the unwanted files starting with 
AF and deleting toward AO. If at most-three simultaneous users are 
desired, then only files AO, Al, and A2 need to be stored. On 
systems that jnay have files local (i.e., unique) to the terminal 
session, a personal file will be created locally* an d should be 
pursed %rtien the terminal session Is complete. 




XIV. THE CADA DISPLAX BOOK 



The CADA Display Book, a companion but separate publication, is 
available. It provides examples of the use of each component in the 
Monitor. Although it is not feasible to give an example of every 
possible option available in the Monitor, the Display Book does show 
examples for most o| the modules in all of the models of each 
component. 

The examples in the Display Book were used to test each trans- 
lation. It is' advised that the CADA system administrator use the 
examples in the Display Book to check the implementation on the local 
coi^puter system. 

The Display Book may also be used by new users to become 
familiar" with the Monitor. Once the user has seen how a particular 
analysis is presented, other options than those ^f the example 
analysis may be chosen to see" how the results obtained may vary. An 
order form is included at the end of this manual.- 
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CADA RESEARCH GROUP 
ERROR REPORT 

Date Reporter_ ;__Computer 



Module name 
\ine number 



Error Message 



Desdrlbe the sequence of events leading to the error: 



Can you reproduce the' error? 
Remarks : 



Error corrected by [ P^^^ 

Summary of correction: 



